Por que Chibi

O Chibi foi feito para aquele momento em que você percebe que precisa de mais do que “uma ferramenta de IA”. Você precisa de um parceiro que coordene modelos, execute trabalho em segundo plano e se integre aos seus sistemas — sem você ficar “cuidando” de prompts.

Chibi é um companheiro digital baseado no Telegram, assíncrono e auto-hospedado, que orquestra múltiplos provedores de IA e ferramentas para entregar resultados: mudanças de código, sínteses de pesquisa, geração de mídia e tarefas operacionais.

Por que Chibi

• Uma interface (Telegram). Mobile/desktop/web, sempre com você.
• Agnóstico a provedores. Use o melhor modelo para cada tarefa — sem vendor lock-in.
• Execução autônoma. Subagentes trabalham em paralelo; tarefas longas rodam de forma assíncrona.
• Conectado a ferramentas. Sistema de arquivos + terminal + integrações MCP (GitHub, navegador, bancos de dados etc.).
• Auto-hospedado. Seus dados, suas chaves, suas regras.

Provedores de IA suportados (e endpoints)

O Chibi suporta múltiplos provedores por trás de uma única conversa. Adicione uma chave ou várias — o Chibi pode rotear por tarefa.

Provedores de LLM

• OpenAI (modelos GPT)
• Anthropic (Claude)
• Google (Gemini)
• DeepSeek
• Alibaba Cloud (Qwen)
• xAI (Grok)
• Mistral AI
• Moonshot AI
• MiniMax
• Cloudflare Workers AI (muitos modelos open-source)

Endpoints compatíveis com OpenAI (auto-hospedado / local)

• Ollama
• vLLM
• LM Studio
• Qualquer API compatível com OpenAI

Provedores multimodais (opcional)

• Imagens: Google (Imagen, Nano Banana), OpenAI (DALL·E), Alibaba (Qwen Image), xAI (Grok Image), Wan
• Música: Suno
• Voz: ElevenLabs, MiniMax, OpenAI (Whisper)

A disponibilidade exata de modelos depende das suas chaves configuradas e dos recursos habilitados.

🚀 Começo rápido (pip)

Instale o Chibi via pip e execute-o como um aplicativo de linha de comando:

# Instalar o pacote
pip install chibi-bot

# Configurar o agente (adicionar chaves de API, atualizar configurações, etc.)
chibi config

# Iniciar o bot
chibi start

O bot será executado como um serviço em segundo plano. Use comandos de CLI para gerenciá-lo.

🚀 Começo rápido (Docker)

Crie docker-compose.yml:

version: '3.8'

services:
  chibi:
    image: pysergio/chibi:latest
    restart: unless-stopped
    environment:
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}  # Obrigatório
      OPENAI_API_KEY: ${OPENAI_API_KEY}          # Ou qualquer outro provedor
      # Adicione mais chaves de API conforme necessário
    volumes:
      - chibi_data:/app/data

volumes:
  chibi_data: {}

1. Pegue um token de bot com o @BotFather

2. Coloque os segredos no .env

3. Rode:

docker-compose up -d

Próximos passos:

• Guia de instalação: https://chibi.bot/installation
• Referência de configuração: https://chibi.bot/configuration

🔑 Obter chaves de API

Cada provedor requer sua própria chave de API. Aqui estão os links diretos:

Provedores principais:

• OpenAI (GPT, DALL·E): platform.openai.com/api-keys
• Anthropic (Claude): console.anthropic.com
• Google (Gemini, Nano Banana, Imagen): aistudio.google.com/apikey
• DeepSeek: platform.deepseek.com
• xAI (Grok): console.x.ai
• Alibaba (Qwen, Wan): modelstudio.console.alibabacloud.com
• Mistral AI: console.mistral.ai
• Moonshot (Kimi): platform.moonshot.cn
• MiniMax (Voice, MiniMax-M2.x): minimax.io
• Cloudflare Workers AI: dash.cloudflare.com/profile/api-tokens

Ferramentas criativas:

• ElevenLabs (Voice): elevenlabs.io
• Suno (Music, unofficial): sunoapi.org

📖 Guia completo com instruções de configuração: chibi.bot/guides/get-api-keys

Experimente nos primeiros 5 minutos

Cole isto no Telegram depois de fazer o deploy.

1. Planejamento + execução

   Faça 3 perguntas para esclarecer meu objetivo, depois proponha um plano e execute o passo 1.

2. Trabalho em paralelo (subagentes)

   Crie 3 subagentes: um para pesquisar opções, um para rascunhar uma recomendação e um para listar riscos. Retorne uma única decisão.

3. Modo agente (ferramentas)

   Inspecione os arquivos do projeto e resuma o que este repositório faz. Depois proponha 5 melhorias e abra uma checklist.

4. Tarefa em segundo plano

   Inicie uma tarefa em segundo plano: reúna fontes sobre X e entregue uma síntese em 30 minutos. Mantenha-me atualizado.

O que torna o Chibi diferente

🎭 Orquestração multi-provedor

O Chibi consegue manter o contexto enquanto troca de provedor no meio da conversa, ou escolher o melhor modelo por etapa — equilibrando custo, capacidade e velocidade.

🤖 Capacidades de agente autônomo

• Delegação recursiva: subagentes podem criar seus próprios subagentes
• Processamento em segundo plano: tarefas longas executam de forma assíncrona
• Acesso ao sistema de arquivos: ler/escrever/pesquisar/organizar arquivos
• Execução no terminal: rodar comandos com segurança moderada por LLM
• Memória persistente: histórico de conversa sobrevive a reinícios com gestão de contexto/sumarização

🔌 Extensível via MCP (Model Context Protocol)

Conecte o Chibi a ferramentas e serviços externos (ou crie os seus):

• GitHub (PRs, issues, code review)
• Automação de navegador
• Docker / serviços de nuvem
• Bancos de dados
• Ferramentas criativas (Blender, Figma)

Se uma ferramenta puder ser exposta via MCP, o Chibi pode aprender a usá-la.

🎨 Geração de conteúdo rica

• Imagens: Nano Banana, Imagen, Qwen, Wan, DALL·E, Grok
• Música: Suno (inclui modo custom: estilo/letra/voz)
• Voz: transcrição + texto-para-fala (ElevenLabs, MiniMax, OpenAI)

Casos de uso

Desenvolvedores

Você: “Rode os testes e conserte o que estiver quebrado. Eu vou trabalhar no frontend.”
Chibi: *cria um subagente, executa testes, analisa falhas, propõe correções*

Pesquisadores

Você: “Pesquise os últimos avanços em computação quântica. Preciso de uma síntese até amanhã.”
Chibi: *cria múltiplos agentes de pesquisa, agrega fontes, entrega um relatório*

Criadores

Você: “Gere uma cidade cyberpunk e componha uma faixa synthwave para combinar.”
Chibi: *gera uma imagem, cria música, entrega ambos*

Times

Você: “Revise este PR e atualize a documentação de acordo.”
Chibi: *analisa mudanças, sugere melhorias, atualiza docs via MCP*

Privacidade, controle e segurança

• Auto-hospedado: seus dados ficam na sua infraestrutura
• Modo público: usuários podem trazer suas próprias chaves de API (não é necessária uma chave mestra compartilhada)
• Controle de acesso: whitelist de usuários/grupos/modelos
• Opções de armazenamento: volumes locais, Redis ou DynamoDB
• Segurança de ferramentas: ferramentas do agente são configuráveis; execução no terminal é moderada e pode ser restrita

Documentação

• Comece aqui: https://chibi.bot
• Introdução e filosofia: https://chibi.bot/introduction
• Instalação: https://chibi.bot/installation
• Configuração: https://chibi.bot/configuration
• Modo agente: https://chibi.bot/agent-mode
• Guia de MCP: https://chibi.bot/guides/mcp
• Suporte / troubleshooting: https://chibi.bot/support

Requisitos do sistema

• Mínimo: Raspberry Pi 4 / AWS EC2 t4g.nano (2 vCPU, 512MB RAM)
• Arquiteturas: linux/amd64, linux/arm64
• Dependências: Docker (e opcionalmente Docker Compose)

Contribuindo

• Issues: https://github.com/s-nagaev/chibi/issues
• PRs: https://github.com/s-nagaev/chibi/pulls
• Discussões: https://github.com/s-nagaev/chibi/discussions

Por favor, leia CONTRIBUTING.md antes de enviar.

Licença

MIT — veja LICENSE.