Files
ra-h-os/docs/0_overview.md
T
“BeeRad” 0f408bc907 docs: sync documentation from private repo
- 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
2026-01-05 12:42:51 +11:00

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:
  • 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