Repolode
emanueleielo

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