Skip to content

Character and LocalAgent Fields

Nimi uses separate identifiers and owners for persistent Character truth and local AI execution.

Field or conceptOwnerMeaning
Character referenceRealmPersistent identity and social/world reference
PersonaCharacter / WorldCharacterRealmCharacter forms owned by Realm
Character SourceRealmIdentity source Runtime may use for materialization
World SourceRealmWorld context source; not sufficient to create LocalAgent identity
LocalAgent IDRuntimeOwner-scoped local execution entity
LocalAgent ownerRuntimeExplicit owner relation; never inferred from an App cache
Conversation anchorRuntimeOne explicit LocalAgent Conversation
Operational MemoryRuntimeAuthorized LocalAgent recall and retention
Operational KnowledgeRuntimeAuthorized LocalAgent ingestion and retrieval
AI capability executionRuntimeCapability-intent evaluation, implementation selection, quota, budget, and execution diagnostics
Presentation configurationRuntimeDurable LocalAgent inputs for authorized projections
Transient presentation stateRuntimeTurn, state, activity, emotion, voice, and timing projection
Renderer stateAvatar or consuming AppEphemeral rendering, playback, and interaction only

Access fields

Runtime derives account, App identity, authorization, target LocalAgent or scope, and operation from the active session. A consumer may submit a LocalAgent ID as a target, but the ID is not an authorization proof.

Realm JWTs, provider credentials, Runtime session proof, private authorization evidence, raw source context, and account-wide LocalAgent inventory are not App fields.

Continuity

A LocalAgent ID does not identify a Conversation. Consumers keep the explicit Conversation anchor returned by Runtime. Multiple Conversations may belong to one LocalAgent, and multiple LocalAgents may be materialized from one Character Source without sharing mutable operational state.

Source Basis

Documentation for Nimi — the installable, open-source, local-first personal AI product.