> ## 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.

# OrcBot Documentation

> Build autonomous AI agents with strategic reasoning, self-repair, and multi-platform deployment

<div className="relative overflow-hidden bg-gradient-to-br from-[#0B1217] via-[#0f1922] to-[#0B1217] dark:from-[#0B1217] dark:via-[#0f1922] dark:to-[#0B1217] py-20 lg:py-24">
  <div className="absolute inset-0 opacity-20">
    <div
      className="absolute inset-0"
      style={{
  backgroundImage: 'radial-gradient(circle at 2px 2px, rgba(90, 250, 179, 0.15) 1px, transparent 0)',
  backgroundSize: '48px 48px'
}}
    />
  </div>

  <div className="relative max-w-6xl mx-auto px-6 sm:px-8">
    <div className="grid lg:grid-cols-12 gap-8 lg:gap-12 items-center">
      <div className="lg:col-span-7">
        <div className="inline-flex items-center gap-2 px-4 py-2 rounded-full bg-[#5bfab3]/10 dark:bg-[#5bfab3]/10 border border-[#5bfab3]/20 dark:border-[#5bfab3]/20 mb-6">
          <span className="w-2 h-2 rounded-full bg-[#5bfab3] dark:bg-[#5bfab3] animate-pulse" />

          <span className="text-sm font-medium text-[#5bfab3] dark:text-[#5bfab3]">Autonomous AI Agent Framework</span>
        </div>

        <h1 className="text-4xl sm:text-5xl lg:text-6xl font-bold text-white dark:text-white mb-6 leading-tight">
          Build AI Agents That Think, Learn, and Adapt
        </h1>

        <p className="text-lg sm:text-xl text-gray-300 dark:text-gray-300 mb-8 max-w-2xl leading-relaxed">
          OrcBot is a production-ready autonomous AI agent with strategic simulation, self-repair capabilities, and multi-channel deployment. Deploy on Telegram, WhatsApp, Discord, or as a CLI tool.
        </p>

        <div className="flex flex-wrap gap-4">
          <a href="/quickstart" className="inline-flex items-center gap-2 px-6 py-3 rounded-xl bg-[#4affb0] hover:bg-[#5bfab3] text-[#0a0a0a] font-semibold transition-all duration-200 shadow-lg hover:shadow-xl hover:scale-105 no-underline">
            Get Started

            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
            </svg>
          </a>

          <a href="/concepts/architecture" className="inline-flex items-center gap-2 px-6 py-3 rounded-xl bg-transparent hover:bg-white/10 dark:hover:bg-white/10 text-white border border-white/30 dark:border-white/30 font-semibold transition-all duration-200 no-underline">
            Explore Architecture
          </a>
        </div>
      </div>

      <div className="lg:col-span-5 hidden lg:block">
        <div className="relative">
          <div className="absolute inset-0 bg-[#5bfab3]/20 dark:bg-[#5bfab3]/20 blur-3xl rounded-full" />

          <div className="relative bg-[rgba(20,25,30,0.8)] dark:bg-[rgba(20,25,30,0.8)] border border-[rgba(50,70,60,0.6)] dark:border-[rgba(50,70,60,0.6)] rounded-2xl p-6 shadow-2xl">
            <div className="flex items-center gap-2 mb-4">
              <div className="w-3 h-3 rounded-full bg-red-500" />

              <div className="w-3 h-3 rounded-full bg-yellow-500" />

              <div className="w-3 h-3 rounded-full bg-green-500" />
            </div>

            <pre className="text-sm text-gray-300 dark:text-gray-300 overflow-x-auto">
              <code>
                {`$ orcbot run

                                🤖 OrcBot v2.1 initialized
                                🧠 Strategic simulation: ON
                                🛡️  Self-repair: ACTIVE
                                🌐 Multi-channel: Ready

                                > THOUGHT: User needs BTC price
                                > ACTION: web_search("BTC price")
                                > OBSERVATION: $45,234.21
                                > THOUGHT: Delivering via Telegram
                                > ACTION: telegram_send_message()
                                ✓ Task completed successfully`}
              </code>
            </pre>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-2xl sm:text-3xl font-bold text-gray-900 dark:text-white mb-3">
    Quick Start
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Get OrcBot running in minutes with our streamlined setup process.
  </p>

  <Steps>
    <Step title="Install OrcBot">
      Install via npm or use our one-line installer:

      ```bash theme={null}
      npm install -g orcbot
      ```

      Or use the installer:

      ```bash theme={null}
      curl -sSL https://orcbot.ai/install.sh | bash
      ```
    </Step>

    <Step title="Configure Your Agent">
      Set up your API keys and choose your LLM provider:

      ```bash theme={null}
      orcbot ui
      ```

      Navigate to **Manage AI Models** and add your OpenAI, Google Gemini, or other provider credentials.
    </Step>

    <Step title="Start the Agent">
      Launch OrcBot in foreground or daemon mode:

      ```bash theme={null}
      # Foreground mode
      orcbot run

      # Background daemon
      orcbot run --daemon
      ```

      <Note>
        Your agent is now running and ready to receive tasks through the CLI, web gateway, or connected channels.
      </Note>
    </Step>

    <Step title="Push Your First Task">
      Send a task to your agent:

      ```bash theme={null}
      orcbot push "Search for the latest AI news and summarize the top 3 stories"
      ```

      Watch as OrcBot autonomously plans, executes, and delivers results.
    </Step>
  </Steps>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-2xl sm:text-3xl font-bold text-gray-900 dark:text-white mb-3">
    Explore by Topic
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Dive into OrcBot's powerful features and capabilities.
  </p>

  <CardGroup cols={2}>
    <Card title="Core Concepts" icon="brain" href="/concepts/architecture">
      Understand the agent loop, memory system, and decision pipeline that power OrcBot's autonomous reasoning.
    </Card>

    <Card title="Configuration" icon="gear" href="/guides/configuration">
      Configure LLM providers, autonomy settings, and agent-driven optimization policies.
    </Card>

    <Card title="Multi-Channel Setup" icon="messages" href="/guides/telegram">
      Deploy your agent on Telegram, WhatsApp, Discord, or through a web gateway.
    </Card>

    <Card title="Skills System" icon="wand-magic-sparkles" href="/concepts/skills-system">
      Leverage 40+ built-in skills from web search to shell execution, or create custom plugins.
    </Card>

    <Card title="Multi-Agent Orchestration" icon="users" href="/advanced/multi-agent">
      Spawn worker agents to handle parallel tasks with real-time coordination.
    </Card>

    <Card title="Hardware & Robotics" icon="robot" href="/guides/hardware-robotics">
      Integrate OrcBot with hardware systems and robotics platforms for autonomous control.
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-2xl sm:text-3xl font-bold text-gray-900 dark:text-white mb-3">
    Key Features
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Production-ready capabilities for autonomous AI agents.
  </p>

  <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
    <div className="bg-gray-50 dark:bg-[#1a1d27] border border-gray-200 dark:border-[#27272a] rounded-xl p-6 hover:border-[#5bfab3] dark:hover:border-[#5bfab3] transition-colors">
      <div className="w-10 h-10 rounded-lg bg-[#5bfab3]/10 dark:bg-[#5bfab3]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#5bfab3] dark:text-[#5bfab3]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Strategic Simulation</h3>
      <p className="text-sm text-gray-600 dark:text-gray-400">Pre-task planning that anticipates errors like CAPTCHAs and search failures before execution starts.</p>
    </div>

    <div className="bg-gray-50 dark:bg-[#1a1d27] border border-gray-200 dark:border-[#27272a] rounded-xl p-6 hover:border-[#5bfab3] dark:hover:border-[#5bfab3] transition-colors">
      <div className="w-10 h-10 rounded-lg bg-[#5bfab3]/10 dark:bg-[#5bfab3]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#5bfab3] dark:text-[#5bfab3]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Autonomous Self-Repair</h3>
      <p className="text-sm text-gray-600 dark:text-gray-400">Automatic detection and repair of broken plugins using the built-in self\_repair\_skill.</p>
    </div>

    <div className="bg-gray-50 dark:bg-[#1a1d27] border border-gray-200 dark:border-[#27272a] rounded-xl p-6 hover:border-[#5bfab3] dark:hover:border-[#5bfab3] transition-colors">
      <div className="w-10 h-10 rounded-lg bg-[#5bfab3]/10 dark:bg-[#5bfab3]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#5bfab3] dark:text-[#5bfab3]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Multi-Modal Intelligence</h3>
      <p className="text-sm text-gray-600 dark:text-gray-400">Process images, audio, and documents natively across all supported channels.</p>
    </div>

    <div className="bg-gray-50 dark:bg-[#1a1d27] border border-gray-200 dark:border-[#27272a] rounded-xl p-6 hover:border-[#5bfab3] dark:hover:border-[#5bfab3] transition-colors">
      <div className="w-10 h-10 rounded-lg bg-[#5bfab3]/10 dark:bg-[#5bfab3]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#5bfab3] dark:text-[#5bfab3]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">RAG Knowledge Store</h3>
      <p className="text-sm text-gray-600 dark:text-gray-400">Ingest documents and URLs into a semantic search index for persistent knowledge retrieval.</p>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-2xl sm:text-3xl font-bold text-gray-900 dark:text-white mb-3">
    API Reference
  </h2>

  <p className="text-base text-gray-600 dark:text-gray-400 mb-8">
    Explore CLI commands, skills, and configuration options.
  </p>

  <CardGroup cols={3}>
    <Card title="CLI Commands" icon="terminal" href="/api/cli/run">
      Complete reference for all orcbot CLI commands and flags.
    </Card>

    <Card title="Core Skills" icon="toolbox" href="/api/skills/overview">
      Documentation for 40+ built-in skills from web search to orchestration.
    </Card>

    <Card title="Configuration" icon="sliders" href="/api/config/reference">
      All available configuration options and environment variables.
    </Card>
  </CardGroup>
</div>

<div className="mt-20 mb-16 max-w-5xl mx-auto px-6">
  <div className="bg-gradient-to-br from-[#5bfab3]/10 to-[#3c9c6c]/10 dark:from-[#5bfab3]/10 dark:to-[#3c9c6c]/10 border border-[#5bfab3]/30 dark:border-[#5bfab3]/30 rounded-2xl p-8 sm:p-12 text-center">
    <h2 className="text-2xl sm:text-3xl font-bold text-gray-900 dark:text-white mb-4">
      Ready to Build Autonomous AI Agents?
    </h2>

    <p className="text-lg text-gray-600 dark:text-gray-400 mb-8 max-w-2xl mx-auto">
      Get started with OrcBot and deploy production-ready AI agents with strategic reasoning and self-repair in minutes.
    </p>

    <a href="/quickstart" className="inline-flex items-center gap-2 px-8 py-4 rounded-xl bg-[#4affb0] hover:bg-[#5bfab3] text-[#0a0a0a] font-semibold transition-all duration-200 shadow-lg hover:shadow-xl hover:scale-105 no-underline">
      Get Started Now

      <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
      </svg>
    </a>
  </div>
</div>