- Rewrite 3_context-and-memory.md (auto-context system, remove legacy memory) - Create 7_voice.md (voice interface documentation) - Update 0_overview.md, 1_architecture.md, 4_tools-and-workflows.md, 6_ui.md, 8_mcp.md - Add simple human-readable intros to all docs - Update README.md with voice doc reference Synced from ra-h commit 4a3d7e0
3.1 KiB
RA-H Overview
What is RA-H?
RA-H is an AI-powered knowledge management system designed for researchers, thinkers, and anyone who works with ideas. It learns how you think and helps connect ideas across your knowledge base.
Website: ra-h.app Open Source: github.com/bradwmorris/ra-h_os
Design Philosophy
Non-prescriptive & emergent — The system doesn't force you into folders or predefined categories. Organization emerges naturally from your actual content. The structure adapts to how you think, not the other way around.
Everything is connected — Every piece of knowledge can potentially connect to any other. Connections aren't just links — they carry context, explanation, and meaning.
Local-first — Your knowledge network belongs to you, not a platform. Your thinking, research, and connections all belong to you in a portable format you control.
Human + AI — You guide, AI assists. Create custom workflows. Always in control of your knowledge.
Tech Stack
- Frontend: Next.js 15, TypeScript, Tailwind CSS
- Database: SQLite + sqlite-vec (vector search)
- AI Models: Anthropic Claude + OpenAI GPT via Vercel AI SDK
- Desktop: Tauri (Mac app)
- MCP Server: Local connector for Claude Code and external agents
Current Status
- Version: v0.1.21 (January 2026)
- Platforms:
- Mac app (download at ra-h.app/download)
- Open source self-hosted (BYO API keys)
- License: MIT (open source version)
Two Ways to Use RA-H
| Version | Best For | Get It |
|---|---|---|
| Mac App | Most users. One-click install, auto-updates, optional subscription features | ra-h.app/download |
| Open Source | Developers, self-hosters, contributors. BYO API keys, full control | GitHub |
Both versions use the same core codebase. The Mac app adds packaging, auth, and subscription features. The open source version is fully functional with your own API keys.
Key Features
- 3-panel interface: Nodes list, Focus view, Helpers panel
- AI agents: Orchestrator for chat, workflows for deep analysis
- Graph database: Nodes and edges with semantic search
- MCP server: Connect Claude Code and other external agents
- Workflows: Code-first automation (Integrate, custom workflows)
- Extraction tools: YouTube, websites, PDFs
Documentation
| Doc | Description |
|---|---|
| Architecture | Agent hierarchy, system design |
| Schema | Database schema, node/edge structure |
| Context & Memory | How context flows through the system |
| Tools & Workflows | Available tools, workflow system |
| Logging & Evals | Debugging, evaluation framework |
| UI | Component structure, panels, views |
| Voice | Voice interface (STT/TTS) |
| MCP | External agent connector setup |
| Open Source | Sync strategy between repos |