⭐ Star on GitHub

OrcBot Documentation

Local-first autonomous AI agent with multi-agent orchestration, smart heartbeat, decision pipeline, and 4+ LLM providers.

Get Started → View on GitHub

Explore the docs

Quick Start

Install, build, and run OrcBot locally in minutes.

Configuration

Priority order, keys, and runtime configuration via TUI.

Architecture

Core system layout, data paths, and infra flow.

Skills & Plugins

Core skills, plugin system, and self-repair loop.

Web Gateway

Remote management via REST API and WebSocket.

Docker Deployment

Run OrcBot anywhere with Docker Compose.

Autonomy

Heartbeat scheduler, guardrails, and recovery.

Operations

Observability, troubleshooting, and runbooks.

📦 Infrastructure Overview

OrcBot is built with a modular architecture that enables flexible deployment and extensibility.

Channels (Telegram, WhatsApp, Discord, CLI)
    ↓
Agent Core (Decision Engine, Memory, Scheduler)
    ↓
Skills & Tools (Browser, File System, Search)
    ↓
Providers (OpenAI, Google, Bedrock, NVIDIA, OpenRouter)

🔌 Channels

Telegram, WhatsApp, and Discord supported out of the box. Add more in src/channels.

🔍 Search Reliability

Smart fallback: API providers first (Serper, Brave), then browser-based (DDG, Bing, Google).

👥 Multi-Agent

Spawn worker processes for parallel tasks. View in TUI: orcbot ui → Workers.