01 / 12
OdyssAI · 2026

OdyssAI-X — Distributed Inference Engine

OdyssAI-Xthe inference engine.

Run large language models on Apple Silicon clusters. One API — every client.

Clusters MLX CoeOS OpenAI API HuggingFace
Multi-cluster distributed inference 01
CoeOS intelligent skill routing 02
Model manager & HuggingFace downloads 03
OpenAI-compatible API — any client 04
Cloud fallback & local-first routing 05
Overview

Local compute.
One API.

OdyssAI-X turns Apple Silicon clusters into a unified inference backend that speaks OpenAI. Any client — Companion, your IDE, your app — connects without changing a line of code.

Apple Silicon MLX Pipeline inference OpenAI API No cloud required Your data
03 / 12
Main Dashboard

Cluster
Overview

The cluster bar at the top shows every logical cluster at a glance — Argo, teleFast, Telemak, Telemak Multi. Click to inspect any one.

Per-cluster: loaded model, node count, uptime, tokens/s, and full node telemetry with RAM, vRAM, and active runners.

397BBnith model
128 GBGlobal RAM
4Nodes
Cluster bar · Telemetry · Global memory
03
Cluster dashboard
04 / 12
Cluster Internals

Pools &
Nodes

Inside each cluster: named pools group nodes by purpose. The default pool serves interactive inference; a minimax pool runs a different model concurrently.

Node telemetry: RAM, vRAM, load latency, PIDs. Activity badges — Idle · Waiting · Running — update live.

Pools · KV cache · Pipeline mode
04
Pools and telemetry
05 / 12
Cluster Types

teleFast
& Telemak

teleFast — single-node, native, two models loaded simultaneously. 73 GB wired, 15 tok/s, optimised for throughput.

Telemak — multi-node pipeline. Smaller models, more parallel sessions, tensor-parallel coordination. Telemak Multi extends to multi-modal workloads.

teleFast · Telemak · Telemak Multi
05
teleFast cluster
06 / 12
Fleet Management

Model
Matrix

The Models tab shows every model across every cluster in one matrix. Rows are models, columns are clusters — quantization and load status at a glance.

Load, unload, or swap quantizations in one click — no SSH, no shell commands. See redundancy for failover planning.

Models · Quantization · Load / Unload
06
Model matrix
07 / 12
Model Acquisition

HuggingFace
Downloads

Pick target clusters and nodes, paste the HF repo ID, authenticate with a saved token, and start. Downloads run in parallel via hf download across all selected nodes simultaneously.

Progress streams to the UI in real time. Once complete, the model appears in the matrix and is ready to load onto a pool.

hf download · Parallel · Node selector
07
HuggingFace download
08 / 12
Routing Engine

CoeOS

CoeOS classifies each incoming request by skill — conversation, code, analysis, expert — and routes it to the configured cluster and pool.

A waterfall plan defines fallback order: local cluster first, then secondary, then cloud. Saturated? Reroutes silently in <1ms.

This is what powers Companion's Easy mode — automatic model selection, invisible to the user.

Skills · Waterfall · Priority routing
08
CoeOS routing
09 / 12
API Surface

One URL.
Any client.

OdyssAI-X exposes a single OpenAI-compatible base URL. Pick a model alias, copy the config snippet, paste it into your client.

Ready-to-paste configs for: OpenAI SDK · Anthropic SDK · Continue.dev · Hermes. No proxy — your cluster, your model, your data.

OpenAI-compatible · SDK snippets · LAN
09
Endpoints
10 / 12
Hybrid Routing

Cloud
Fallback

Register OpenAI, Mistral, Ollama, or any OpenAI-compatible provider. CoeOS places them in the waterfall wherever you need them.

Local cluster saturated? Fall to Mistral. Mistral errors? Fall to OpenAI. The user sees uninterrupted responses. The endpoint format is identical across all providers.

OpenAI · Mistral · Ollama · Transparent
10
Cloud providers
11 / 12
Configuration

Settings

Three layers of configuration.

General — sliding window, file TTL, REFIT count and retry behavior.

Clusters — full fleet topology. Node IPs, peer relationships, resource totals.

Telemak — auto-refit on schedule. Single model slot cycles automatically.

General · Clusters · Auto-refit
General
General settings
Clusters
Cluster settings
Telemak
Telemak settings
OdyssAI-X

The layer your
stack sits on.

Distributed inference · Multi-cluster routing · OpenAI-compatible API
Model management · Cloud fallback · Local-first, always.

odyssai.eu