https://github.com/sonic182/minibot

Your personal AI assistant - self-hosted, containerized, and intentionally opinionated.
https://github.com/sonic182/minibot

agentic-ai ai-assistant asyncio llm multi-agent python self-hosted sqlite telegram-bot

Last synced: about 2 months ago
JSON representation

Your personal AI assistant - self-hosted, containerized, and intentionally opinionated.

• Host: GitHub
• URL: https://github.com/sonic182/minibot
• Owner: sonic182
• License: mit
• Created: 2026-02-05T21:51:29.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-04-19T21:14:08.000Z (2 months ago)
• Last Synced: 2026-04-19T21:33:44.480Z (2 months ago)
• Topics: agentic-ai, ai-assistant, asyncio, llm, multi-agent, python, self-hosted, sqlite, telegram-bot
• Language: Python
• Homepage: https://sonic182.github.io/minibot/
• Size: 1.22 MB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md
  • Security: docs/security.rst
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
MiniBot 🤖

=======

[![PyPI version](https://img.shields.io/pypi/v/minibot)](https://pypi.org/project/minibot/)

Your personal AI assistant for Telegram - self-hosted, auditable, and intentionally opinionated.

📖 **[Full documentation](https://sonic182.github.io/minibot)**

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.

![Generate image with python_execute (1)](demo_pics/gen_image_with_python_1.jpeg)

![Generate image with python_execute (2)](demo_pics/gen_image_with_python_2.jpeg)

[llm-async]: https://github.com/sonic182/llm-async