Skip to main content

MiniBot 🤖

PyPI version

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

📖 Full documentation

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, fixed-interval, and cron recurrence) persisted in SQLite.
  • 🤝 Multi-agent orchestration with specialist agent definitions and skill packs.
  • ⚙️ minibot configure: interactive terminal wizard to create or update config.toml.
  • 📊 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) Generate image with python_execute (2)

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.7.0.tar.gz (181.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

minibot-0.7.0-py3-none-any.whl (254.6 kB view details)

Uploaded Python 3

File details

Details for the file minibot-0.7.0.tar.gz.

File metadata

  • Download URL: minibot-0.7.0.tar.gz
  • Upload date:
  • Size: 181.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for minibot-0.7.0.tar.gz
Algorithm Hash digest
SHA256 53076be4a20ac9c73ac0c3a990ba9455473d048f7ec1cb28138b3eb289b2d21f
MD5 c220eeee7910256c7d030cdc1677555f
BLAKE2b-256 62326baf7415d63b2dde4214a1946617b3d282e798bd30cebf6dbe62a80ee372

See more details on using hashes here.

File details

Details for the file minibot-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: minibot-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 254.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for minibot-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 95bce0a69475c0332913ce92a861e1a08f50e632bd0e2bc86736bf2b41b7651b
MD5 7326c99a7905464a4fcc4016b573bb83
BLAKE2b-256 50838844b91438fbec3d4e67243785cb101ffb639cbb9dc42f52fab24235a4b4

See more details on using hashes here.

Release history Release notifications | RSS feed

0.15.0

2 files

0.14.3

2 files

0.14.2

2 files

0.14.1

2 files

0.14.0

2 files

0.13.0

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.0

2 files

This release

0.7.0 This release

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page