Developers
The surfaces you build against
LokiAI is a control plane, a device agent protocol and a set of runtime adapters. Everything else is a consequence of those three.
- Agent protocol
- Runtime adapters
- Deployment events
- API in development
01Architecture
Four moving parts
Control plane
Accounts, devices, model records, deployment state and credential issue. Stateless with respect to inference.
Device agent
Registers capability, holds a device-scoped credential, executes deployments and streams state.
Artifact resolver
Turns a repository reference into one pinned file with recorded format, size and URL evidence.
Runtime adapter
A narrow interface per runtime: load, warm, infer, release. Adding a runtime does not touch the control plane.
02Lifecycle
A deployment, step by step
- Agent authenticates over WSS with its device credential and publishes its capability profile.
- Control plane resolves the requested outcome to a candidate artifact and runs compatibility checks.
- On pass, a short-lived download instruction is issued to that device only.
- Agent downloads directly from the CDN, verifies integrity, then loads through the matching runtime adapter.
- State transitions and failure reasons are streamed back and stored with the deployment record.
03Integration
What is open, and when
Model formats
GGUF and TFLite are deployable today. Additional formats are under evaluation.
Public API
Account, device, model and deployment resources. In development — contact us for early access.
SDK direction
Thin clients over the same API, starting with TypeScript and Python.
New device classes
Implement the agent protocol for your platform; the control plane needs no change.
Events
Deployment state changes are streamed, with structured failure reasons rather than opaque errors.
Docs
Getting started, pairing, compatibility and troubleshooting are maintained alongside the agent.
Building on LokiAI or porting an agent?
Start with the docs, then contact us with the platform you are targeting.
