Runtime
Runtime is an independent local service that turns authorized product intent into AI execution. Apps use its public capability surface through the SDK; they do not import Runtime internals or call providers directly.
What Runtime owns
Runtime owns:
- Local and Cloud AI consumption, implementation selection, resource scheduling, Token, Quota, Budget, and credential custody;
- LocalAgent materialization and lifecycle from a Realm-issued Character Source;
- LocalAgent Conversation, operational Memory and Knowledge, state, voice, events, and presentation projections;
- local process, model, service, stream, and audit behavior;
- App identity and authorization derived from the active protected session;
- bounded bridges to independent Realm and optional external capabilities.
These responsibilities stay with Runtime regardless of whether the consumer is Nimi Home, Desktop, Avatar, a direct SDK client, or a scaffolded App.
Ownership Boundaries
Realm owns Character identity, Character Source, World Source, canonical World data, social truth, and World history. Runtime may consume admitted source context but cannot redefine it.
Apps and first-party surfaces own their product UI, interaction, and ephemeral cache. They cannot take over Conversation, Memory, Knowledge, LocalAgent, provider, credential, session, or authorization truth.
General Workflow, MCP, and World Evolution are not Runtime core prerequisites. An optional external action capability reports its own unavailable state and does not block LocalAgent Conversation, Memory, Knowledge, voice, or unrelated capability execution.
Read paths
- Streaming
- Multimodal
- Agent Execution
- Memory And Knowledge
- Connectors And Providers
- Local Models
- Account And Session
- Delegated Capability
- Local Audit