How g9000/animaos works
AnimaOS is a desktop-centered personal AI system: a user interacts through the desktop, which exposes conversation and persistent personal-data features backed by a server and local runtime components. The documented conversation model uses tool calls for internal thought and response, with local or hosted inference providers. The graph emphasizes documented capabilities and sampled wiring; some desktop-to-server and server-to-runtime relationships are conventional but unsampled, so those links are marked unverified.
Main entry points: main.py HTTP server · App.tsx Desktop app · client.ts API client · chat.py Chat API
Components 25
Desktop experience
- Desktop app
apps/desktop/src/App.tsx - Chat interface
apps/desktop/src/pages/chat/Chat.tsx - Personal data views
apps/desktop/src/pages/memory/Memory.tsx - Database browser
apps/desktop/src/pages/Database.tsx - API client
packages/api-client/src/client.ts
Application server
- HTTP server
apps/server/src/anima_server/main.py - Chat API
apps/server/src/anima_server/api/routes/chat.py - Consciousness API
apps/server/src/anima_server/api/routes/consciousness.py - Knowledge API
apps/server/src/anima_server/api/routes/knowledge.py - Runtime state
apps/server/src/anima_server/models/runtime.py
Memory and cognition
- Thread lifecycle
apps/server/src/anima_server/services/agent/thread_manager.py - Memory retrieval
apps/server/src/anima_server/services/memory/retrieval_router.py - Content authority
apps/server/src/anima_server/services/corefs/content_authority.py - Memory engine
packages/anima-core/src/engine.rs - Persistent path engine
packages/anima-core/src/path_engine.rs - Knowledge cards
packages/anima-core/src/cards.rs - Knowledge graph
packages/anima-core/src/graph.rs
Runtime integrations
- Animus terminal
apps/animus/src/main.rs - Terminal session
apps/animus/src/app.rs - Mod server
apps/anima-mod/src/server.ts - Mod management
apps/anima-mod/src/management/router.ts - Mod registry
apps/anima-mod/src/core/registry.ts
Other components
- User
- Model provider
- Database
Connections 26
- User → Desktop app: uses
apps/desktop/src/App.tsx - Desktop app → Chat interface: routes to
apps/desktop/src/App.tsx - Desktop app → Personal data views: routes to
apps/desktop/src/App.tsx - Desktop app → Database browser: routes to
apps/desktop/src/App.tsx - Chat interface → API client: requests
- Personal data views → API client: requests
- Database browser → API client: requests
apps/desktop/src/pages/Database.tsx - API client → HTTP server: calls
- HTTP server → Chat API: mounts
apps/server/src/anima_server/main.py - HTTP server → Consciousness API: mounts
apps/server/src/anima_server/main.py - HTTP server → Knowledge API: mounts
apps/server/src/anima_server/main.py - Chat API → Thread lifecycle: manages threads
- Thread lifecycle → Runtime state: reads and writes
apps/server/src/anima_server/services/agent/thread_manager.py - Thread lifecycle → Content authority: uses
apps/server/src/anima_server/services/agent/thread_manager.py - Memory retrieval → Knowledge cards: retrieves
- Memory engine → Knowledge cards: serializes
packages/anima-core/src/engine.rs - Memory engine → Knowledge graph: serializes
packages/anima-core/src/engine.rs - Persistent path engine → Memory engine: persists
packages/anima-core/src/path_engine.rs - HTTP server → Database: initializes storage
- User → Animus terminal: uses
apps/animus/src/main.rs - Animus terminal → Terminal session: starts session
apps/animus/src/main.rs - Terminal session → HTTP server: connects
- Mod server → Mod registry: loads modules
apps/anima-mod/src/server.ts - Mod server → Mod management: mounts routes
apps/anima-mod/src/server.ts - Mod management → Mod registry: installs and controls
apps/anima-mod/src/server.ts - Chat API → Model provider: tool-call loop