RA-OS - Knowledge Management System

What This Is

LLM-powered knowledge management system built for emergence and flexibility. This is the open source, self-hosted version with BYO (bring your own) API keys.

Tech Stack

Next.js 15 + TypeScript + Tailwind CSS
SQLite + sqlite-vec (vector search)
Anthropic (Claude) + OpenAI (GPT) models via Vercel AI SDK
3-panel UI: Nodes | Focus | Helpers

Quick Start

git clone https://github.com/bradwmorris/ra-h_os.git
cd ra-h_os
npm install
npm rebuild better-sqlite3
scripts/dev/bootstrap-local.sh
npm run dev

Open http://localhost:3000 and enter your API keys (OpenAI + Anthropic).

Agent System

Orchestrator (Easy Mode): GPT-5 Mini - DEFAULT - fast, cheap orchestration Orchestrator (Hard Mode): Claude Sonnet 4.5 - deep reasoning (toggle via UI) Oracle (Wise ra-h): GPT-5 - complex workflows, multi-step planning Delegates: GPT-4o mini - spawned for write operations, extraction, batch tasks

Tools available: queryNodes, queryEdge, searchContentEmbeddings, webSearch, think, executeWorkflow, createNode, updateNode, createEdge, updateEdge, youtubeExtract, websiteExtract, paperExtract

Workflows System

Code-first registry: Defined in src/services/workflows/registry.ts
Integrate workflow: Database-wide connection discovery for focused nodes
- 5-step process: plan → ground → search → contextualize → append
- Finds 3-8 strong connections across your database

Database

SQLite at ~/Library/Application Support/RA-H/db/rah.sqlite
Schema defined in docs/2_schema.md
Health check: GET /api/health/db

Key Files

src/services/agents/ - Agent executors and delegation
src/tools/ - All available tools
src/config/prompts/ - Agent system prompts
src/services/workflows/ - Workflow definitions
src/components/ - React components

Documentation

docs/0_overview.md - System overview
docs/1_architecture.md - Architecture details
docs/2_schema.md - Database schema
docs/4_tools-and-workflows.md - Tools reference

Contributing

See CONTRIBUTING.md for guidelines. Issues and PRs welcome!

License

MIT - see LICENSE file

2.1 KiB Raw Blame History