The Package

The Package

Aperio is a full-stack personal memory layer for AI agents.

---

🧠 Persistent Memory

7 structured types survive every conversation, every tool, every session: fact preference project decision solution source person

🔍 Semantic Search

Powered by vector embeddings (@huggingface/transformers or Voyage AI).
Ask for "my TypeScript projects" and get results by meaning, not keywords.
Full-text search (SQLite FTS5 or Postgres tsvector) as fallback when no embeddings exist.

📚 Wiki System

Persistent wiki articles with:

• Hybrid search (semantic + full-text)
• Auto-refresh from linked memories
• Draft/propose workflow

🔬 Code Graph

Index your codebase with tree-sitter:

• Symbol search (functions, classes, methods, types)
• Callers/callees analysis (depth up to 5)
• Repository overview with file/symbol counts
• Toggle with APERIO_CODEGRAPH=on

📄 Document Graph

Index notes, reports, docs, PDFs, Word, Excel, PowerPoint, email:

• Full-text + vector search
• Section-level navigation
• Reference tracking
• Toggle with APERIO_DOCGRAPH=on

⚡ Real-time Streaming

Responses stream live via SSE + WebSocket.
Reasoning models show a collapsible thinking bubble — toggle it on/off in the header.

🎨 4 Themes

Light · Dark · Aurora (indigo-pink) · System. Persisted in localStorage.

🗣️ Round-table Mode

Two-agent cross-review for critical answers.
Agent A answers, Agent B reviews — they iterate until they agree.
Toggle with /discuss on or ROUNDTABLE_AGENTS in .env.

🧹 Auto-Deduplication

Background job finds near-duplicate memories via cosine similarity (97% threshold).

📤 Data Export/Import

Portable JSON export of all memories + wiki. Import to restore.

🗑️ Delete Memories

Hover any memory card to reveal a trash icon. No page reload needed.

🌐 i18n

26 languages (24 official EU + Chinese + Japanese).
Full 304-key interface catalog for every locale.
Check parity with npm run i18n:check.

🔒 Security

• Path guards for all file operations
• Optional AES-256-GCM database encryption (keychain-backed)
• Configurable auth token
• Network guards (DNS rebinding, host validation)
• Rate limiting
• Crash breaker (auto-exit on repeated fatals)

⚙️ Settings Overlay

Full configuration UI in the browser — no .env editing required:

• AI provider and model selection
• Embedding provider
• Code/doc graph toggles
• Allowed file paths
• Database connections
• GitHub triage
• Simple ↔ Advanced toggle

🖥️ Terminal Client

Full-featured REPL with 18+ slash-commands, streaming, and file attachments.