Open Source (RA-OS)
Self-host your own RA-H knowledge graph with full source access
RA-H Open Source (RA-OS)
RA-OS is the fully open source version of RA-H. It gives you complete control over your knowledge graph—run it on your own machine, use your own API keys, and keep your data entirely private.
What is RA-OS?
RA-OS is a streamlined version of RA-H designed for developers and privacy-conscious users who want to:
- Self-host their knowledge management system
- Use their own API keys for AI features (OpenAI, Anthropic, etc.)
- Maintain full control over their data
- Integrate with external tools via the MCP server
Key Features
| Feature | Description |
|---|---|
| Local SQLite | All data stored locally in a single SQLite file |
| MCP Server | Connect Claude Code, Cursor, or Windsurf to your knowledge graph |
| Guides System | AI-assisted workflows for common tasks |
| BYO API Keys | Use your own OpenAI/Anthropic/OpenRouter keys |
| MIT License | Fork it, modify it, deploy it however you want |
What's Different from the Mac App?
RA-OS is a "lite" version focused on core knowledge management. Some features from the Mac app are not included:
| Feature | Mac App | RA-OS |
|---|---|---|
| Voice Mode | Yes | No |
| Agent Mode (Opus 4.5) | Yes | No |
| Auto-updates | Yes | Manual (git pull) |
| Native desktop app | Yes | Web browser |
| Included AI credits | Yes | BYO API keys |
Quick Start
# Clone the repository
git clone https://github.com/bradwmorris/ra-h_os.git
# Navigate to the directory
cd ra-h_os
# Install dependencies
npm install
# Start the development server
npm run dev
Then open http://localhost:3000 in your browser.
Next Steps
- Installation — Detailed setup instructions
- Configuration — API keys and environment variables
- MCP Server — Connect external AI tools
- Contributing — How to contribute to RA-OS