Open Source AI Agent Framework

Your AI agent,
your infrastructure.

Self-hosted AI agent framework with three-layer memory, autonomous thinking, multi-provider support, and 10+ communication channels. No vendor lock-in.

# Clone and install
$ git clone https://github.com/adriandemian/reefbot.ai && cd reefbot.ai
$ bun install
# Configure your agent
$ cp config.example.yaml ~/.reefbot/config.yaml
$ export OPENAI_API_KEY="sk-..."
# Launch
$ bot gateway
Gateway running on http://localhost:18789
Telegram connected. Slack connected. Ready.

Built for autonomy, designed for control.

🧠

Three-Layer Memory

Episodic conversations, semantic embeddings with sqlite-vec, and procedural learned skills. Persistent across sessions with hybrid FTS5 + vector search.

🔄

Autonomous Think Loop

Continuous think-plan-act cycle. Set goals, let it run. Pause with a file, redirect with live feedback, audit every cycle.

🔌

Multi-Provider

OpenAI, Anthropic, Google, Groq, Together, DeepSeek, Ollama. Auto-detected by model prefix. Swap providers without code changes.

💬

10+ Channels

Telegram, Slack, WhatsApp, Discord, Matrix, Signal, CLI, REST API, WebSocket, MCP. One config, all channels.

🤖

Multi-Agent Teams

Run multiple agents concurrently with shared memory coordination. CPO shapes, Builder implements. Shared SQLite knowledge store.

🛡️

Safety & Sandboxing

Exec command allowlists, workspace restrictions, SSRF protection, circuit breakers, token budgets. Safety tiers from permissive to locked down.

🧩

Plugin SDK

Extend with custom tools, channels, hooks, and cron jobs. Drop a manifest.json in the plugins directory and go.

🗳️

AI Debate System

Structured multi-agent debates with specialized bot panels, 10 phases, weighted voting, and decision export. Run in Telegram groups.

📦

Zero Build Step

Bun-native runtime. Execute TypeScript directly. SQLite with WAL mode. No transpilation, no bundling. Just run.

Works with everything.

Connect any provider, deploy to any channel.

Providers

OpenAIAnthropicGoogle GeminiGroqTogether AIDeepSeekOllama (local)

Channels

TelegramSlackWhatsAppDiscordMatrixSignalREST APIWebSocketMCPCLI

Up and running in 2 minutes.

Requires Bun runtime and at least one LLM API key.

1

Clone the repository

git clone https://github.com/adriandemian/reefbot.ai.git
cd reefbot.ai
2

Install dependencies

bun install

Don't have Bun? Install it here — one command.

3

Configure your agent

cp config.example.yaml ~/.reefbot/config.yaml
export OPENAI_API_KEY="sk-..."

Works with any supported provider. Set the matching API key and model prefix.

4

Launch

bot gateway    # reactive — responds to messages
bot think      # autonomous — thinks continuously
bot chat       # interactive CLI session
5

Or use Docker

docker-compose up -d

Pre-built image with persistent volumes for sessions and data.

Architecture

reefagent
Channels
Telegram
Slack
WhatsApp
Discord
Matrix
Signal
CLI
REST API
WebSocket
MCP
Integrations
Plugins
Webhooks
Cron
Model Router
multi-provider
Agent Runner
+ Tool Sandbox
Think Loop
autonomous
Soul & Identity
self-evolving
Storage
SQLite + WAL
Episodic
Semantic
Procedural
FTS5 + Vec
Hybrid Search
Goals
Goal Engine
Hierarchical
Safety
Safety Tiers
Circuit Breakers

Ready to deploy your own agent?

Open source. Self-hosted. Your data stays yours.