Metadata-Version: 2.4
Name: openbotx
Version: 0.0.6
Summary: AI assistant platform with web interface, task board, and multi-channel support
Author-email: Paulo Coutinho <paulocoutinhox@gmail.com>
Maintainer-email: Paulo Coutinho <paulocoutinhox@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/openbotx/openbotx
Project-URL: Repository, https://github.com/openbotx/openbotx
Project-URL: Bug Tracker, https://github.com/openbotx/openbotx/issues
Keywords: ai,agent,assistant,bot,llm,skills,chatbot,telegram,websocket,fastapi,litellm
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.12.5
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: fastapi>=0.128.0
Requires-Dist: uvicorn[standard]>=0.40.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: aiofiles>=24.0.0
Requires-Dist: websockets<16.0
Requires-Dist: python-multipart>=0.0.18
Requires-Dist: litellm>=1.50.0
Requires-Dist: json-repair>=0.30.0
Requires-Dist: python-telegram-bot>=22.6
Requires-Dist: croniter>=5.0.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: deprecated>=1.2.0
Requires-Dist: boto3>=1.42.38
Requires-Dist: readability-lxml>=0.8.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: chardet<6.0.0,>=3.0.2
Requires-Dist: pyjwt>=2.9.0
Requires-Dist: faster-whisper>=1.2.1
Requires-Dist: filetype>=1.2.0
Requires-Dist: click>=8.3.1
Provides-Extra: dev
Requires-Dist: ruff>=0.14.14; extra == "dev"
Requires-Dist: build>=1.4.0; extra == "dev"
Requires-Dist: twine>=6.2.0; extra == "dev"
Dynamic: license-file

# 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--3.13-blue?style=flat-square" alt="Python 3.11-3.13"></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
- **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-3.13 and [UV](https://github.com/astral-sh/uv).

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

## From Source

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

## Documentation

- [About](docs/about.md) — Project overview, features and comparison
- [Execution Flow](docs/flow.md) — Complete agent execution flow
- [Architecture](docs/architecture.md) — System design and components
- [Configuration](docs/configuration.md) — Full config.yml reference
- [API Reference](docs/api.md) — REST API and WebSocket endpoints
- [Skills](docs/skills.md) — Creating and managing skills
- [Tools](docs/tools.md) — Built-in tools reference

## License

MIT — see [LICENSE](LICENSE) for details.

## Links

- [GitHub](https://github.com/openbotx/openbotx) · [PyPI](https://pypi.org/project/openbotx/) · [Template Starter](https://github.com/openbotx/template-starter)
- [Issues](https://github.com/openbotx/openbotx/issues) · [Discussions](https://github.com/openbotx/openbotx/discussions)

Made with ❤️ by [Paulo Coutinho](https://github.com/paulocoutinhox)
