# Minibot

> Minibot is an open-source, self-hosted AI assistant for Telegram, built in Python.
> It provides persistent memory, tools, skills, scheduled automations, MCP integration,
> and multi-agent orchestration. Telegram-first, SQLite-first, async-first, auditable.

## Docs

- [Getting Started](https://sonic182.github.io/minibot/getting_started.html): install and run
- [Demo](https://sonic182.github.io/minibot/demo.html): screenshots of images, browsing, charts, and voice
- [Providers](https://sonic182.github.io/minibot/providers.html): configure LLM providers and compatible endpoints
- [Extending Minibot](https://sonic182.github.io/minibot/extending.html): the customization ladder
- [Python extensions](https://sonic182.github.io/minibot/extensions.html): tools, events, services, channels
- [Extension API reference](https://sonic182.github.io/minibot/extension-api.html): ExtensionContext, ToolBinding, events
- [Events](https://sonic182.github.io/minibot/events.html): event-bus reference
- [Agent skills](https://sonic182.github.io/minibot/skills.html): SKILL.md format, discovery order, bundled skills
- [Multi-agent orchestration](https://sonic182.github.io/minibot/agents.html)
- [Prompt packs](https://sonic182.github.io/minibot/prompts.html)
- [MCP integration](https://sonic182.github.io/minibot/mcp.html)
- [Suggested MCP servers](https://sonic182.github.io/minibot/mcp_servers.html)
- [Architecture](https://sonic182.github.io/minibot/architecture.html)
- [Configuration reference](https://sonic182.github.io/minibot/config.html)
- [CLI reference](https://sonic182.github.io/minibot/cli.html)
- [Agent tools](https://sonic182.github.io/minibot/tools.html)
- [Async tasks](https://sonic182.github.io/minibot/tasks.html)
- [Scheduled tasks & automation](https://sonic182.github.io/minibot/scheduler.html)
- [Audio transcription](https://sonic182.github.io/minibot/audio.html)
- [RAG & persistent knowledge](https://sonic182.github.io/minibot/rag.html)
- [Relation graph](https://sonic182.github.io/minibot/graph.html)
- [Credential vault](https://sonic182.github.io/minibot/vault.html): encrypted secrets and secret references
- [Security & sandboxing](https://sonic182.github.io/minibot/security.html)

## Features

- Self-hosted Telegram AI assistant
- Persistent memory (SQLite)
- Agent tools: Python, Bash, HTTP, files, grep, patch editing
- Agent skills (Markdown)
- Multi-agent orchestration with delegation
- Scheduled prompts (one-shot, interval, cron)
- Async background task workers (SQLite or RabbitMQ)
- MCP integration
- RAG over SQLite or Qdrant
- Optional relation graph
- Browser automation (Playwright)
- Voice (speech-to-text)
- Python extensions for tools, events, services, and channels

## Links

- [Documentation](https://sonic182.github.io/minibot/)
- [GitHub](https://github.com/sonic182/minibot)
- [PyPI](https://pypi.org/project/minibot/)