> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orcbot.buzzchat.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to OrcBot

> A production-ready strategic AI agent with autonomous reasoning, multi-modal intelligence, and self-healing capabilities

## What is OrcBot?

OrcBot is a next-generation **autonomous reasoning agent** designed for production environments. Built on the ReAct (Reasoning + Acting) architecture, it combines strategic planning, multi-modal intelligence, and self-healing capabilities to execute complex tasks with minimal human intervention.

<Note>
  OrcBot v2.1 introduces hardened skill infrastructure, richer channel interactions, RAG knowledge storage, and battle-tested multi-channel delivery across Telegram, WhatsApp, and Discord.
</Note>

## Key Features

### Strategic Intelligence

<CardGroup cols={2}>
  <Card title="Strategic Simulation Layer" icon="chess">
    Pre-task planning that anticipates errors (like CAPTCHAs or search failures) before they happen
  </Card>

  <Card title="Autonomous Immune System" icon="shield-check">
    Automatically detects broken plugin code and uses self-repair capabilities to fix itself
  </Card>

  <Card title="Agent-Driven Config" icon="gear">
    Intelligent configuration system where agents can safely optimize settings while security-critical configs remain protected
  </Card>

  <Card title="Termination Review" icon="clipboard-check">
    Built-in safety layer that reviews proposed actions to prevent premature task termination
  </Card>
</CardGroup>

### Multi-Modal Capabilities

<Info>
  OrcBot natively supports images, audio, documents, and voice via multiple communication channels.
</Info>

* **Image Analysis**: Process and analyze images through Telegram, WhatsApp, and Discord
* **Voice Notes**: Text-to-speech with automatic fallback across channels
* **Document Processing**: PDF parsing and content extraction
* **Image Generation**: Built-in AI image generation with multi-channel delivery

### Autonomous Operations

```mermaid theme={null}
graph LR
    A[Task Input] --> B[Simulation Layer]
    B --> C[Decision Engine]
    C --> D[Skill Execution]
    D --> E[Memory Storage]
    E --> F[Termination Review]
    F --> G[Delivery]
```

* **Smart Heartbeat**: Context-aware autonomy with exponential backoff and productivity tracking
* **Multi-Agent Orchestration**: Spawn worker processes for parallel task execution
* **Event-Driven Polling**: Efficient condition monitoring without busy-waiting
* **RAG Knowledge Store**: Semantic vector search for durable information recall

### Communication Channels

OrcBot supports multiple communication platforms with rich interaction capabilities:

<Tabs>
  <Tab title="Telegram">
    * Inline keyboard buttons
    * Native polls
    * Emoji reactions
    * Message editing and pinning
    * File and voice note delivery
  </Tab>

  <Tab title="WhatsApp">
    * QR code authentication
    * Media file sharing
    * Voice notes
    * Group chat support
    * Contact management
  </Tab>

  <Tab title="Discord">
    * Server and channel integration
    * Rich embeds
    * Slash commands
    * File attachments
    * Voice message support
  </Tab>

  <Tab title="Web Gateway">
    * REST API endpoints
    * WebSocket real-time events
    * Remote task management
    * Dashboard interface
    * API key authentication
  </Tab>
</Tabs>

## Architecture Overview

OrcBot is built with a modular architecture designed for production reliability:

### Core Components

1. **Agent Core** (`Agent.ts`): Main orchestration loop with ReAct reasoning
2. **Decision Stack**: Multi-layered decision engine with guardrails
3. **Memory System**: Multi-tier storage (short/episodic/long-term/vector)
4. **Skills System**: Core and dynamic plugin-based capabilities
5. **Channel Adapters**: Communication platform integrations
6. **Configuration Manager**: Hot-reloadable YAML-based configuration

### Decision Pipeline

The decision pipeline includes sophisticated guardrails:

* **Deduplication**: Prevents repeated tool calls within the same action
* **Safety Checks**: Validates parameters and prevents dangerous operations
* **Loop Detection**: Identifies and breaks infinite reasoning loops
* **Task Complexity Classifier**: Dynamic resource allocation based on task difficulty
* **Skill Routing**: Intent-based tool selection for optimal matching

## Use Cases

<AccordionGroup>
  <Accordion title="Personal AI Assistant">
    Deploy OrcBot as your intelligent personal assistant:

    * Monitor news and send daily briefings
    * Track system health and send alerts
    * Schedule reminders and recurring tasks
    * Answer questions with context from your knowledge base
  </Accordion>

  <Accordion title="DevOps Automation">
    Automate infrastructure and development workflows:

    * Execute shell commands and scripts
    * Monitor logs and system metrics
    * Deploy applications and run tests
    * Coordinate multi-step deployment pipelines
  </Accordion>

  <Accordion title="Research & Analysis">
    Intelligent research and data gathering:

    * Web scraping with anti-bot stealth
    * Document ingestion and semantic search
    * Multi-source information synthesis
    * Automated report generation
  </Accordion>

  <Accordion title="Customer Support Bot">
    Autonomous customer interaction:

    * Multi-channel customer engagement
    * Context-aware response generation
    * Knowledge base integration
    * Escalation to human operators
  </Accordion>

  <Accordion title="IoT & Robotics Control">
    Control hardware through safe command interfaces:

    * High-level intent planning
    * Safety-validated command execution
    * Multi-sensor data processing
    * Real-time monitoring and alerts
  </Accordion>
</AccordionGroup>

## Performance Benchmarks

OrcBot v2.1 delivers production-grade performance:

| Metric                | Score  | Description                                |
| --------------------- | ------ | ------------------------------------------ |
| **Conversational IQ** | 9.5/10 | State-of-the-art context management        |
| **Task Planning**     | 8.9/10 | Dynamic simulation with error anticipation |
| **Web Autonomy**      | 9.2/10 | Resilient browsing with fallback chains    |
| **System Resilience** | 9.7/10 | Self-repair and daemon stability           |

<Tip>
  Run `orcbot latency --llm` to benchmark your local installation and measure subsystem performance.
</Tip>

## Security & Privacy

OrcBot is designed with security as a core principle:

* **Local-First**: All memory, logs, and profiles stay on your machine
* **No Hidden Uploads**: Network calls only when explicitly required by skills
* **Config Isolation**: Secrets loaded from environment variables
* **Safe Mode**: Disable command execution and skill creation
* **Plugin Controls**: Allow/deny lists for third-party plugins
* **Admin-Only Skills**: Elevated capabilities gated to configured admins
* **Policy-Based Config**: SAFE/APPROVAL/LOCKED tiers for configuration management

## What's New in v2.1

<CardGroup cols={2}>
  <Card title="Skill Infrastructure" icon="wrench">
    * Enhanced `download_file` with streaming and MIME detection
    * 3-tier channel detection for `send_file`
    * Pagination support in `read_file`
    * Content guards in `write_file`
  </Card>

  <Card title="Telegram Rich UX" icon="paper-plane">
    * Inline keyboard buttons
    * Native polls
    * Emoji reactions with fallback
    * Message editing and pinning
  </Card>

  <Card title="Browser Hardening" icon="globe">
    * Full anti-bot stealth parity
    * Search URL save/restore
    * Shared browser for article extraction
    * Blank-page counter tracking
  </Card>

  <Card title="RAG Knowledge Store" icon="database">
    * Document and URL ingestion
    * Chunk-based embedding storage
    * Collection namespacing
    * Tag filtering support
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Get OrcBot running in 5 minutes
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Detailed setup for all platforms
  </Card>

  <Card title="Configuration" icon="sliders" href="/configuration">
    Configure OrcBot for your needs
  </Card>

  <Card title="Skills & Plugins" icon="puzzle-piece" href="/skills">
    Extend OrcBot with custom capabilities
  </Card>
</CardGroup>