How animalab/anima works
Anima is a local-first memory engine for assistants. Its main workflow accepts memories through the REST API, persists them in SQLite, and retrieves them through hybrid search; optional ask/chat flows use an LLM to turn retrieved context into answers. Separate branches provide background reflection and consolidation, MCP access, and a web console for search, chat, and memory inspection. The excerpts show API routing, selected handler-to-store calls, and some UI/API behavior; several subsystem connections are documented in the README but their implementation was not sampled.
Main entry points: handlers.rs Memory and chat handlers · main.rs HTTP server · store.rs Memory store · consolidator.rs Memory consolidation
Components 21
API runtime
- HTTP server
crates/anima-server/src/main.rs - API routing
crates/anima-server/src/app.rs - Memory and chat handlers
crates/anima-server/src/handlers.rs - Provider configuration
crates/anima-server/src/config.rs
Memory lifecycle
- Background processor
crates/anima-server/src/processor.rs - Memory consolidation
crates/anima-consolidate/src/consolidator.rs - Memory model
crates/anima-core/src/memory.rs - Namespace isolation
crates/anima-core/src/namespace.rs
Retrieval and models
- Hybrid search
crates/anima-core/src/search.rs - Temporal ranking
crates/anima-core/src/temporal.rs - Embedding providers
crates/anima-embed/src/model.rs - Cross-encoder reranker
crates/anima-embed/src/reranker.rs
Persistence
- Memory store
crates/anima-db/src/store.rs - SQLite pool and schema
crates/anima-db/src/pool.rs - Vector indexes
crates/anima-db/src/vector.rs - Keyword index
crates/anima-db/src/fts.rs
Integration surfaces
- Web console
web/src/App.tsx - Web API client
web/src/api/client.ts - MCP bridge
mcp/src/index.ts
Other components
- Assistant or user
- LLM provider
Connections 23
- Assistant or user → Web console: uses
README.md - Assistant or user → MCP bridge: uses
README.md - Assistant or user → HTTP server: calls REST API
README.md - HTTP server → API routing: starts
crates/anima-server/src/main.rs - API routing → Memory and chat handlers: routes requests
crates/anima-server/src/app.rs - Web console → Web API client: uses
web/src/App.tsx - Web API client → HTTP server: sends REST requests
README.md - MCP bridge → HTTP server: integrates via REST
README.md - HTTP server → Provider configuration: loads settings
crates/anima-server/src/main.rs - Memory and chat handlers → Memory store: reads and writes memories
crates/anima-server/src/handlers.rs - Memory store → SQLite pool and schema: uses SQLite pool
crates/anima-db/src/store.rs - SQLite pool and schema → Vector indexes: initializes vector tables
crates/anima-db/src/pool.rs - Memory store → Keyword index: uses keyword index
crates/anima-db/src/store.rs - Memory and chat handlers → Hybrid search: performs retrieval
- Hybrid search → Temporal ranking: uses temporal ranking
crates/anima-core/src/search.rs - Memory and chat handlers → Cross-encoder reranker: reranks candidates
crates/anima-server/src/handlers.rs - Memory and chat handlers → Embedding providers: requests embeddings
- Background processor → Memory consolidation: runs consolidation
- Memory and chat handlers → Background processor: queues processing
crates/anima-server/src/handlers.rs - Memory and chat handlers → Namespace isolation: enforces namespace scope
- Provider configuration → LLM provider: configures provider
- Memory consolidation → LLM provider: requests completions
- LLM provider → Memory consolidation: returns completions