OpenBotX

<p align="center"> <a href="https://github.com/openbotx/openbotx" target="_blank" rel="noopener noreferrer"> <img width="280" src="https://raw.githubusercontent.com/openbotx/openbotx/main/extras/images/logo.png" alt="OpenBotX Logo"> </a> </p> <p align="center"> <a href="https://pypi.org/project/openbotx/"><img src="https://img.shields.io/pypi/v/openbotx?color=brightgreen&style=flat-square" alt="PyPI version"></a> <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11%2B-blue?style=flat-square" alt="Python 3.11+"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" alt="License: MIT"></a> </p> <p align="center"> <a href="https://github.com/openbotx/openbotx/actions/workflows/build.yml"><img src="https://img.shields.io/github/actions/workflow/status/openbotx/openbotx/build.yml?style=flat-square" alt="Build status"></a> </p> <p align="center"> An open-source platform for orchestrating AI agents.<br> One command to start. Everything from the browser. No coding required. </p>

---

What is OpenBotX?

OpenBotX lets you create and manage AI agents from a web control panel. Chat, assign tasks, automate workflows, and monitor everything in real time — from your phone, tablet, or computer.

• One command to start — no Docker, no infrastructure
• Multi-agent — multiple agents with independent models, tools, and workspaces
• Real-time task board — Kanban view with live status across all agents
• Skills system — extend agents with Markdown files, no coding needed
• Marketplace — browse and install community skills directly from the web UI
• Built-in tools — file ops, shell, web search, HTTP client, browser automation, RSS, scheduler, and more
• Multi-channel — web and Telegram, same pipeline
• Any LLM provider — Anthropic, OpenAI, Google, OpenRouter, or any OpenAI-compatible endpoint
• Secure — sandboxed workspaces, shell safety guards, JWT auth

Quick Start

Requirements: Python 3.11+ and UV.

# Install
uv tool install openbotx

# Create a project
mkdir my-assistant && cd my-assistant
openbotx init

# Configure API keys
cp .env.example .env
nano .env  # add your ANTHROPIC_API_KEY or other provider key

# Start
openbotx start

Your browser opens at http://localhost:8000. Log in with admin / admin.

One-Click Deploy

Platform
Render
Heroku
DigitalOcean
Hostinger

See the deploy docs for details on each platform.

From Source

git clone https://github.com/openbotx/openbotx.git
cd openbotx
make setup
source .venv/bin/activate
openbotx start

Documentation

• About — Project overview, features and comparison
• Execution Flow — Complete agent execution flow
• Architecture — System design and components
• Configuration — Full config.yml reference
• API Reference — REST API and WebSocket endpoints
• Skills — Creating and managing skills
• Tools — Built-in tools reference
• Deploy — One-click deploy

License

MIT — see LICENSE for details.

Links

• GitHub · PyPI · Template Starter
• Issues · Discussions

Made with ❤️ by Paulo Coutinho