Self-hosted Telegram-first AI assistant with async tooling, memory, and scheduling.
Project description
MiniBot 🤖
Your personal AI assistant for Telegram - self-hosted, auditable, and intentionally opinionated.
Top features
- 🤖 Personal assistant, not SaaS: your chats, memory, and scheduled prompts stay in your instance.
- 🎯 Opinionated by design: Telegram-centric flow, small tool surface, and explicit config over hidden magic.
- 🏠 Self-hostable: Dockerfile + docker-compose provided for easy local deployment.
- 💻 Local console channel for development/testing without Telegram.
- 💬 Telegram channel with chat/user allowlists, long-polling or webhook modes, and multimodal inputs.
- 🧠 Provider support via llm-async:
openai,openai_responses,openrouter, and more. - 🧰 Configurable tools: chat memory, KV notes, HTTP fetch, calculator, datetime, Python execution, Bash, file storage, grep, speech-to-text, and MCP server bridges.
- ⏰ Scheduled prompts (one-shot and interval recurrence) persisted in SQLite.
- 🤝 Multi-agent orchestration with specialist agent definitions and skill packs.
- 📊 Structured logfmt logs and a focused async test suite.
Demo
Example: generate images with the python_execute tool and receive them in Telegram.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
minibot-0.3.0.tar.gz
(150.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
minibot-0.3.0-py3-none-any.whl
(212.4 kB
view details)
File details
Details for the file minibot-0.3.0.tar.gz.
File metadata
- Download URL: minibot-0.3.0.tar.gz
- Upload date:
- Size: 150.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb1dfe842afc67a70ddd8c87f705f068a9b1afb0c88f1474783578cdadd2dae5
|
|
| MD5 |
5dd2baabbe0efb81a807ae4aefd50901
|
|
| BLAKE2b-256 |
7634b212c4aa4a29b2e3cc6b65011c716e3b1800d2192ecff3873b3c129d0e8e
|
File details
Details for the file minibot-0.3.0-py3-none-any.whl.
File metadata
- Download URL: minibot-0.3.0-py3-none-any.whl
- Upload date:
- Size: 212.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
215fa6f1ef701f8748a796cd47a8fcee158f48eb0385fb778d798f35e02ba018
|
|
| MD5 |
0597ce568fd21b98285a8c3d3a62bf18
|
|
| BLAKE2b-256 |
0a8589e9c5eadc8e4bfb7355adec974d34c3a158f96477d94d1ec96d40857ca1
|
