Um agente de IA leve e self-hosted, escrito em Go, que roda no seu servidor e funciona pelo Telegram com modelos da Anthropic, OpenAI ou OpenRouter.
emanueleielo/ciana-parrot
Assistente pessoal de IA auto-hospedado que conversa pelo Telegram, executa tarefas agendadas e se conecta a servidores MCP e ferramentas do host.
- Estrelas
- 77
- Forks
- 19
- Issues abertas
- 1
- Último commit
- há 17 dias
O que é?
O CianaParrot é um assistente pessoal de IA auto-hospedado, desenvolvido com DeepAgents, LangChain e LangGraph. O agente é executado em um sandbox Docker e acessa o sistema operacional do host por meio de um gateway de bridges seguras. Os usuários interagem com ele principalmente pelo Telegram, e o agente também pode criar tarefas cron, por intervalo e de execução única a partir do chat.
O projeto oferece suporte a vários provedores de LLM, incluindo Anthropic, OpenAI, Google Gemini, Groq, Ollama, OpenRouter e vLLM. É possível configurar várias categorias de modelos para que o agente alterne entre eles durante uma conversa. As bridges do host dão acesso a ferramentas como Spotify, Reminders, Obsidian e 1Password, e também é possível conectar servidores MCP externos. Toda a configuração é feita em um único arquivo YAML.
As skills são adicionadas ao colocar uma pasta no diretório de skills, onde são registradas automaticamente como ferramentas do agente. A memória é armazenada em arquivos Markdown que o próprio agente pode atualizar. A implantação é baseada em Docker, com alvos make para build, execução e inicialização do gateway; um script de instalação cuida dos pré-requisitos e da configuração das chaves de API.
Recursos principais
- 01Converse com o agente pelo Telegram, com uma arquitetura de canais extensível para outros canais
- 02Oferece suporte a Anthropic, OpenAI, Gemini, Groq, Ollama, OpenRouter e vLLM como provedores de LLM
- 03Tarefas agendadas cron, por intervalo ou de execução única, que podem ser criadas pelo chat
- 04Bridges do gateway do host para ferramentas como Spotify, Reminders, Obsidian e 1Password
- 05As skills são registradas automaticamente como ferramentas do agente quando colocadas na pasta de skills
- 06Integração com servidores MCP e memória persistente baseada em Markdown
Casos de uso
- Executar um assistente de IA privado no próprio servidor e conversar com ele pelo Telegram
- Agendar lembretes recorrentes ou verificações automatizadas que o agente executa por conta própria
- Conectar um modelo local pelo Ollama ou vLLM, mantendo os dados na própria infraestrutura
- Ampliar o assistente com skills personalizadas ou ferramentas MCP externas
Tópicos
Perguntas frequentes
- O que é ciana-parrot?
- Assistente pessoal de IA auto-hospedado que conversa pelo Telegram, executa tarefas agendadas e se conecta a servidores MCP e ferramentas do host. O CianaParrot é um assistente pessoal de IA auto-hospedado, desenvolvido com DeepAgents, LangChain e LangGraph. O agente é executado em um sandbox Docker e acessa o sistema operacional do host por meio de um gateway de bridges seguras. Os usuários interagem com ele principalmente pelo Telegram, e o agente também pode criar tarefas cron, por intervalo e de execução única a partir do chat.
- ciana-parrot é gratuito? Qual é a licença?
- ciana-parrot é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- ciana-parrot ainda é mantido?
- Manutenção ativa. O último commit de ciana-parrot foi em 5 de out. de 2026.
- Para que posso usar ciana-parrot?
- Executar um assistente de IA privado no próprio servidor e conversar com ele pelo Telegram Agendar lembretes recorrentes ou verificações automatizadas que o agente executa por conta própria Conectar um modelo local pelo Ollama ou vLLM, mantendo os dados na própria infraestrutura Ampliar o assistente com skills personalizadas ou ferramentas MCP externas
- Onde consigo ciana-parrot?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/emanueleielo/ciana-parrot
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Assistente pessoal de IA multiagente e auto-hospedável, criado com LangGraph, que conecta e-mail, calendário, documentos e tarefas com aprovação humana antes de executar ações.
Runtime de companhia de IA local-first e auto-hospedado, com personagem que prioriza o vietnamita, memória local em SQLite, canais Telegram/Zalo, skills e ferramentas com acesso condicionado a permissões.
Uma plataforma auto-hospedada de agentes de IA persistentes, com memória de longo prazo, que colaboram e respondem em canais de chat e rodam em um único container.
Servidor pessoal de agente de IA auto-hospedado em um único binário Rust, com execução isolada de ferramentas, suporte a vários provedores de LLM e canais como Telegram e Discord.
Assistente pessoal de IA open source para planejamento, escrita e conhecimento pessoal, que roda no Mac ou pode ser hospedado por você com suas próprias chaves de modelo.