rivet-memory

RivetOS

Lightweight, stable agent runtime. Apache 2.0 licensed.

Zero bloat. Zero lock-in. Just the loop.

RivetOS is a personal AI agent runtime built for reliability. A tiny, stable core routes messages between channels and LLM providers. Everything else — providers, channels, tools, memory — is a plugin.

Container-first. The container IS the product. Security via isolation, setup via wizard, updates via source rebuild. One config file drives everything.

Features

• Tiny core, fat plugins — The kernel stays under 5,000 lines. Everything else is swappable.
• Streaming-first — AsyncIterable<StreamEvent> from every provider. Responses stream in real-time.
• 6 LLM providers — Anthropic (Claude), xAI (Grok), Google (Gemini), Ollama, openai-compat (vLLM / TGI / llama.cpp llama-server / any OpenAI-compatible server), claude-cli (Claude Code subscription).
• 4 channel plugins — Discord, Telegram, Agent (HTTP inter-agent), Voice (xAI Realtime).
• MCP transport plugin — Expose RivetOS tools (memory, web, skills) to external MCP clients over StreamableHTTP.
• 20+ built-in tools — Shell, file I/O, search, web, memory, skills, interaction, MCP client, coding pipeline, delegation, sub-agents.
• Multi-agent mesh — Delegate tasks across agents. Local or remote. Transparent routing.
• Hook system — Composable pipeline for safety, auto-actions, session lifecycle.
• Interactive setup — rivetos init walks you through everything step by step.
• Container deployment — Docker Compose or Proxmox LXC. Images built from source, plugins included.
• Source-based updates — rivetos update pulls, rebuilds, restarts. Forks and custom plugins are first-class.
• Full control surface — /stop, /steer, /new, /status, /model, /think, /context.
• Interrupt that works — AbortController propagated to every API call and tool.
• Persistent memory — PostgreSQL + pgvector. Hybrid FTS + vector search. Summary DAG. Learning loop.
• Structured observability — JSON logging, runtime metrics, health endpoints, rivetos doctor.
• LTS releases — Pin a version. It won't break for 12 months.
• Apache 2.0 — No CLA, no dual-licensing, no surprises. Patent grant included.

Quick Start

git clone https://github.com/philbert440/rivetOS.git
cd rivetOS
npm install

# Interactive setup — configures everything
npx rivetos init

# Or manual setup:
cp config.example.yaml config.yaml
cp .env.example .env
# Edit both files, then:
npx rivetos start

See Getting Started for the full guide.

Architecture

┌───────────────────────────────────────────────────────────────┐
│                       RivetOS Runtime                         │
│                                                               │
│  ┌──────────┐     ┌──────────┐    ┌────────────────────────┐  │
│  │ Channels │───> │  Router  │───>│     Turn Handler       │  │
│  │ (plugin) │     │ (domain) │    │     (application)      │  │
│  │          │     │          │    │                        │  │
│  │ Discord  │     │ message  │    │ hooks → media → loop   │  │
│  │ Telegram │     │  → agent │    │  → stream → respond    │  │
│  │ Agent    │     │  → prov  │    │  → memory append       │  │
│  │ Voice    │     │          │    │                        │  │
│  └──────────┘     └──────────┘    └───────────┬────────────┘  │
│       ▲                                       │               │
│       │              ┌────────────────────────┘               │
│       │              ▼                                        │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────┐     │
│  │ Response │<───│Workspace │    │     Memory           │     │
│  │ sent to  │    │ (domain) │    │    (plugin)          │     │
│  │ channel  │    │          │    │                      │     │
│  │          │    │ CORE.md  │    │ append transcript    │     │
│  │          │    │ USER.md  │    │ search context       │     │
│  │          │    │ MEMORY.md│    │ hybrid FTS+vector    │     │
│  └──────────┘    └──────────┘    └──────────────────────┘     │
│                                                               │
│  ┌──────────────┐  ┌──────────┐  ┌────────────────────────┐   │
│  │ Observability│  │   Mesh   │  │      Boot Layer        │   │
│  │              │  │          │  │                        │   │
│  │ Metrics      │  │ Registry │  │ Config → Registrars    │   │
│  │ Health API   │  │ Discover │  │ → Lifecycle            │   │
│  │ Audit logs   │  │ Delegate │  │                        │   │