{"id":44843751,"url":"https://github.com/s-nagaev/chibi","last_synced_at":"2026-05-29T01:02:36.199Z","repository":{"id":148849463,"uuid":"618134408","full_name":"s-nagaev/chibi","owner":"s-nagaev","description":"Your Digital Companion. Self-hosted Telegram bot orchestrating multiple AI providers (OpenAI, Anthropic, Google, xAI, DeepSeek, Mistral, Alibaba, MiniMax) with autonomous agent capabilities, MCP integrations, and async task execution. Not a tool. A partner.","archived":false,"fork":false,"pushed_at":"2026-05-22T20:47:47.000Z","size":2392,"stargazers_count":49,"open_issues_count":3,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-22T21:36:30.400Z","etag":null,"topics":["ai-agent","anthropic","autonomous-agents","chatbot","claude","deepseek","digital-companion","docker","google-gemini","image-generation","llm","mcp","mistral-ai","multi-provider","openai","python","raspberry-pi","self-hosted","telegram","xai"],"latest_commit_sha":null,"homepage":"https://chibi.bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/s-nagaev.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-23T20:30:32.000Z","updated_at":"2026-05-19T13:04:49.000Z","dependencies_parsed_at":"2023-11-26T21:23:10.505Z","dependency_job_id":"beefef49-19da-4839-ab79-7d7f072ec371","html_url":"https://github.com/s-nagaev/chibi","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/s-nagaev/chibi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-nagaev%2Fchibi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-nagaev%2Fchibi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-nagaev%2Fchibi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-nagaev%2Fchibi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s-nagaev","download_url":"https://codeload.github.com/s-nagaev/chibi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-nagaev%2Fchibi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33632271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","anthropic","autonomous-agents","chatbot","claude","deepseek","digital-companion","docker","google-gemini","image-generation","llm","mcp","mistral-ai","multi-provider","openai","python","raspberry-pi","self-hosted","telegram","xai"],"created_at":"2026-02-17T04:04:14.218Z","updated_at":"2026-05-29T01:02:36.174Z","avatar_url":"https://github.com/s-nagaev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003cimg width=150 src=\"https://github.com/s-nagaev/chibi/raw/main/docs/logo.png\" alt=\"Chibi Logo\"\u003e\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eYour Digital Companion. Not a Tool. A Partner.\u003c/strong\u003e\u003cbr/\u003e\n  \u003cspan\u003eSelf-hosted, asynchronous Telegram bot that orchestrates multiple AI providers, tools, and sub-agents to get real work done.\u003c/span\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/s-nagaev/chibi/actions/workflows/build.yml\"\u003e\u003cimg src=\"https://github.com/s-nagaev/chibi/actions/workflows/build.yml/badge.svg\" alt=\"Build\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.codefactor.io/repository/github/s-nagaev/chibi\"\u003e\u003cimg src=\"https://www.codefactor.io/repository/github/s-nagaev/chibi/badge\" alt=\"CodeFactor\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/pysergio/chibi\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/pysergio/chibi\" alt=\"Docker Pulls\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/chibi-bot/\"\u003e\u003cimg src=\"https://static.pepy.tech/personalized-badge/chibi-bot?period=total\u0026units=INTERNATIONAL_SYSTEM\u0026left_color=GRAY\u0026right_color=BLUE\u0026left_text=pip+installs\" alt=\"PyPI Downloads\"\u003e\u003c/a\u003e  \n  \u003ca href=\"https://hub.docker.com/r/pysergio/chibi/tags\"\u003e\u003cimg src=\"https://img.shields.io/badge/arch-arm64%20%7C%20amd64-informational\" alt=\"Architectures\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/s-nagaev/chibi/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/s-nagaev/chibi\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://chibi.bot\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-chibi.bot-blue\" alt=\"Documentation\"\u003e\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🌍 Read this in other languages:\u003c/strong\u003e\u003cbr/\u003e\n  \u003ca href=\"docs/README.es.md\"\u003eEspañol\u003c/a\u003e •\n  \u003ca href=\"docs/README.pt-BR.md\"\u003ePortuguês (Brasil)\u003c/a\u003e •\n  \u003ca href=\"docs/README.uk.md\"\u003eУкраїнська\u003c/a\u003e •\n  \u003ca href=\"docs/README.id.md\"\u003eBahasa Indonesia\u003c/a\u003e •\n  \u003ca href=\"docs/README.tr.md\"\u003eTürkçe\u003c/a\u003e •\n  \u003ca href=\"docs/README.ru.md\"\u003eРусский\u003c/a\u003e •\n  \u003ca href=\"docs/README.ja.md\"\u003e日本語\u003c/a\u003e •\n  \u003ca href=\"docs/README.zh-TW.md\"\u003e繁體中文\u003c/a\u003e •\n  \u003ca href=\"docs/README.zh-CN.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nChibi is built for the moment you realize you need more than “an AI tool.” You need a **partner** that can coordinate models, run work in the background, and integrate with your systems - without you babysitting prompts.\n\n**Chibi** is an asynchronous, self-hosted **Telegram-based digital companion** that orchestrates multiple AI providers and tools to deliver outcomes: code changes, research syntheses, media generation, and operational tasks.\n\n---\n\n## Why Chibi\n\n- **One interface (Telegram).** Mobile/desktop/web, always with you.\n- **Provider-agnostic.** Use the best model for each task - without vendor lock-in.\n- **Autonomous execution.** Sub-agents work in parallel; long tasks run asynchronously.\n- **Tool-connected.** Filesystem + terminal + MCP integrations (GitHub, browser, DBs, etc.).\n- **Self-hosted.** Your data, your keys, your rules.\n\n---\n\n## Supported AI providers (and endpoints)\n\nChibi supports multiple providers behind a single conversation. Add one key or many - Chibi can route per task.\n\n### LLM providers\n\n- **OpenAI** (GPT models)\n- **Anthropic** (Claude)\n- **Google** (Gemini)\n- **DeepSeek**\n- **Alibaba Cloud** (Qwen)\n- **xAI** (Grok)\n- **Mistral AI**\n- **Moonshot AI**\n- **MiniMax**\n- **ZhipuAI** (GLM models)\n- **Cloudflare Workers AI** (many open-source models)\n\n### OpenAI-compatible endpoints (self-host / local)\n\n- **Ollama**\n- **vLLM**\n- **LM Studio**\n- **Any** OpenAI-compatible API\n\n### Multimodal providers (optional)\n\n- **Images:** Google (Imagen, Nano Banana), OpenAI (DALL·E), Alibaba (Qwen Image), xAI (Grok Image), Wan, ZhipuAI (CogView), MiniMax\n- **Music:** Suno\n- **Voice:** ElevenLabs, MiniMax, OpenAI (Whisper)\n\n\u003e Exact model availability depends on your configured provider keys and enabled features.\n\n---\n\n## 🚀 Quick Start (pip)\n\nInstall Chibi via pip and run it as a command-line application:\n\n```bash\n# Install the package\npip install chibi-bot\n\n# Set up the agent (add API keys, update settings, etc)\nchibi config\n\n# Start the bot\nchibi start\n```\n\nThe bot will run as a background service. Use CLI commands to manage it.\n\n### CLI Commands\n\n| Command         | Description                           |\n|-----------------|---------------------------------------|\n| `chibi start`   | Start the bot as a background service |\n| `chibi stop`    | Stop the running bot                  |\n| `chibi restart` | Restart the bot                       |\n| `chibi config`  | Generate or edit configuration        |\n| `chibi logs`    | View bot logs                         |\n\n---\n\n## 🚀 Quick start (Docker)\n\nCreate `docker-compose.yml`:\n\n```yaml\nversion: '3.8'\n\nservices:\n  chibi:\n    image: pysergio/chibi:latest\n    restart: unless-stopped\n    environment:\n      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}  # Required\n      OPENAI_API_KEY: ${OPENAI_API_KEY}          # Or any other provider\n      # Add more API keys as needed\n    volumes:\n      - chibi_data:/app/data\n\nvolumes:\n  chibi_data: {}\n```\n\n1) Get a bot token from [@BotFather](https://t.me/BotFather)\n\n2) Put secrets into `.env`\n\n3) Run:\n\n```bash\ndocker-compose up -d\n```\n\nNext:\n- **Installation guide:** https://chibi.bot/installation\n- **Configuration reference:** https://chibi.bot/configuration\n\n---\n\n## 🔑 Getting API Keys\n\nEach provider requires its own API key. Here are the direct links:\n\n**Major Providers:**\n- **OpenAI** (GPT, DALL·E): [platform.openai.com/api-keys](https://platform.openai.com/api-keys)\n- **Anthropic** (Claude): [console.anthropic.com](https://console.anthropic.com/)\n- **Google** (Gemini, Nano Banana, Imagen, Voice): [aistudio.google.com/apikey](https://aistudio.google.com/app/apikey)\n- **DeepSeek**: [platform.deepseek.com](https://platform.deepseek.com/)\n- **xAI** (Grok): [console.x.ai](https://console.x.ai/)\n- **Alibaba** (Qwen, Wan): [modelstudio.console.alibabacloud.com](https://modelstudio.console.alibabacloud.com?tab=playground#/api-key)\n- **Mistral AI**: [console.mistral.ai](https://console.mistral.ai/)\n- **Moonshot** (Kimi): [platform.moonshot.cn](https://platform.moonshot.cn/)\n- **MiniMax** (Voice, MiniMax-M2.x): [minimax.io](https://www.minimax.io)\n- **ZhipuAI** (GLM, CogView): [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)\n- **Cloudflare Workers AI**: [dash.cloudflare.com/profile/api-tokens](https://dash.cloudflare.com/profile/api-tokens)\n\n**Creative Tools:**\n- **ElevenLabs** (Voice): [elevenlabs.io](https://elevenlabs.io/)\n- **Suno** (Music, unofficial): [sunoapi.org](https://sunoapi.org/)\n\n\u003e 📖 **Full guide with setup instructions:** [chibi.bot/guides/get-api-keys](https://chibi.bot/guides/get-api-keys)\n\n---\n\n## Try this in the first 5 minutes\n\nPaste these into Telegram after you deploy.\n\n1) **Planning + execution**\n\u003e Ask me 3 questions to clarify my goal, then propose a plan and execute step 1.\n\n2) **Parallel work (sub-agents)**\n\u003e Spawn 3 sub-agents: one to research options, one to draft a recommendation, one to list risks. Return a single decision.\n\n3) **Agent mode (tools)**\n\u003e Inspect the project files and summarize what this repo does. Then propose 5 improvements and open a checklist.\n\n4) **Background task**\n\u003e Start a background task: gather sources on X and deliver a synthesis in 30 minutes. Keep me updated.\n\n---\n\n## What makes Chibi different\n\n### 🎭 Multi-provider orchestration\nChibi can keep context while switching providers mid-thread, or choose the best model per step - balancing **cost**, **capability**, and **speed**.\n\n### 🤖 Autonomous agent capabilities\n- **Recursive delegation:** spawn sub-agents that can spawn their own sub-agents\n- **Background processing:** long-running tasks execute asynchronously\n- **Filesystem access:** read/write/search/organize files\n- **Terminal execution:** run commands with LLM-moderated security\n- **Persistent memory:** conversation history survives restarts with context management/summarization\n\n### 🔌 Extensible via MCP (Model Context Protocol)\nConnect Chibi to external tools and services (or build your own):\n\n- GitHub (PRs, issues, code review)\n- Browser automation\n- Docker / cloud services\n- Databases\n- Creative tools (Blender, Figma)\n\nIf a tool can be exposed via MCP, Chibi can learn to use it.\n\n### 🎨 Rich content generation\n- **Images:** Nano Banana, Imagen, Qwen, Wan, DALL·E, Grok\n- **Music:** Suno (including custom mode: style/lyrics/vocals)\n- **Voice:** transcription + text-to-speech (ElevenLabs, MiniMax, OpenAI)\n\n---\n\n## Use cases\n\n**Developers**\n```\nYou: “Run the tests and fix what’s broken. I’ll work on the frontend.”\nChibi: *spawns sub-agent, executes tests, analyzes failures, proposes fixes*\n```\n\n**Researchers**\n```\nYou: “Research the latest developments in quantum computing. I need a synthesis by tomorrow.”\nChibi: *spawns multiple research agents, aggregates sources, delivers a report*\n```\n\n**Creators**\n```\nYou: “Generate a cyberpunk cityscape and compose a synthwave track to match.”\nChibi: *generates an image, creates music, delivers both*\n```\n\n**Teams**\n```\nYou: “Review this PR and update the documentation accordingly.”\nChibi: *analyzes changes, suggests improvements, updates docs via MCP*\n```\n\n---\n\n## Privacy, control, and safety\n\n- **Self-hosted:** your data stays on your infrastructure\n- **Public Mode:** users can bring their own API keys (no shared master key required)\n- **Access control:** whitelist users/groups/models\n- **Storage options:** local volumes, Redis, or DynamoDB\n- **Tool safety:** agent tools are configurable; terminal execution is moderated and can be restricted\n\n---\n\n## Documentation\n\n- **Start here:** https://chibi.bot\n- Introduction \u0026 philosophy: https://chibi.bot/introduction\n- Installation: https://chibi.bot/installation\n- Configuration: https://chibi.bot/configuration\n- Agent mode: https://chibi.bot/agent-mode\n- MCP guide: https://chibi.bot/guides/mcp\n- Support / troubleshooting: https://chibi.bot/support\n\n---\n\n## System requirements\n\n- **Minimum:** Raspberry Pi 4 / AWS EC2 t4g.nano (2 vCPU, 512MB RAM)\n- **Architectures:** `linux/amd64`, `linux/arm64`\n- **Dependencies:** Docker (and optionally Docker Compose)\n\n---\n\n## Contributing\n\n- Issues: https://github.com/s-nagaev/chibi/issues\n- PRs: https://github.com/s-nagaev/chibi/pulls\n- Discussions: https://github.com/s-nagaev/chibi/discussions\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting.\n\n---\n\n## License\n\nMIT  -  see [LICENSE](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReady to meet your digital companion?\u003c/strong\u003e\u003cbr/\u003e\n  \u003ca href=\"https://chibi.bot/start\"\u003e\u003cstrong\u003eGet Started →\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-nagaev%2Fchibi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs-nagaev%2Fchibi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-nagaev%2Fchibi/lists"}