Repolode
Enviar
smixs

smixs/iva-agent

Assistente de IA para Telegram auto-hospedado que arquiva áudios, fotos e mensagens em um vault de memória em Markdown pesquisável.

Alternativa open source a:Notion AI

Ver no GitHubSite
Estrelas
265
Forks
58
Issues abertas
24
Último commit
há 5 horas

O que é?

Iva é um assistente de IA para Telegram que roda no seu próprio servidor. Mensagens, áudios, fotos, PDFs e publicações encaminhadas são armazenados como arquivos Markdown simples, datados, em um vault compatível com Obsidian. Com o tempo, o sistema cria cartões estruturados para contatos, projetos, decisões e notas.

A memória é organizada em camadas: a transcrição de cada dia é mantida na íntegra, uma consolidação noturna agrupa os dias em semanas, meses e anos, e um arquivo curto, CORE.md, é incluído em todos os prompts. A busca combina BM25 com reclassificação baseada em grafo de links, com um modo vetorial opcional. O assistente também transcreve áudios via Deepgram, descreve imagens usando o modelo de visão do provedor de modelos, gerencia tarefas e lembretes, pesquisa na web por meio de vários provedores e acessa o Google Workspace via CLI gws.

Iva é instalado com um único script de shell no Ubuntu ou Debian, e também há instruções para instalar no Mac. Ele oferece suporte a vários provedores de modelos, incluindo OpenRouter, Ollama Cloud e assinaturas do Claude ou OpenAI, além de endpoints personalizados compatíveis com OpenAI. Um modo userbot opcional pode ler e enviar mensagens por uma conta pessoal do Telegram. O projeto alerta que isso contraria os termos do Telegram e fica por conta e risco do usuário.

Recursos principais

  • 01Transcreve áudios com Deepgram e descreve fotos usando a capacidade de visão do modelo.
  • 02Armazena na íntegra, em Markdown, as mensagens de cada dia e as consolida em resumos semanais, mensais e anuais.
  • 03Mantém um arquivo CORE.md, incluído em todos os prompts para fornecer contexto persistente.
  • 04Pesquisa na memória com BM25 e reclassificação baseada em grafo de links, com busca vetorial opcional.
  • 05Gerencia tarefas, lembretes e um resumo diário.
  • 06Conecta-se ao Gmail, Calendar, Drive, Sheets, Docs e Tasks via CLI gws, e oferece suporte a servidores MCP e skills.

Casos de uso

  • Relembrar o que foi combinado com um cliente meses atrás.
  • Transformar um áudio longo em uma lista de tarefas, um rascunho de e-mail ou um cartão de reunião.
  • Manter um CRM pessoal de contatos e acompanhamentos dentro do Telegram.
  • Usar um assistente pessoal auto-hospedado que mantém os dados no seu próprio servidor.

Início rápido

  1. 1

    Obtenha um token de bot no BotFather

  2. 2

    Clone o repositório

    git clone https://github.com/smixs/iva-agent.git ~/iva
  3. 3

    Execute o instalador a partir do repositório clonado e responda às perguntas

    cd ~/iva && bash install.sh
  4. 4

    Envie uma mensagem para o seu bot para que o assistente conclua a configuração

Antes de usar

  • Requer Node.js 24 ou posterior e um servidor que você mesmo gerencie, então é necessário se dedicar à hospedagem própria.
  • Requer uma chave de API ou assinatura de um provedor de modelos. As chamadas ao modelo e de transcrição são enviadas para APIs na nuvem pagas por você.
  • O recurso opcional de userbot viola os termos de serviço do Telegram e pode fazer com que sua conta seja limitada ou banida.

Tópicos

#personal-agent#telegram-bot#llm#long-term-memory#self-hosted#obsidian#knowledge-graph#voice-assistant#agent#ai-agent

Perguntas frequentes

O que é iva-agent?
Assistente de IA para Telegram auto-hospedado que arquiva áudios, fotos e mensagens em um vault de memória em Markdown pesquisável. Iva é um assistente de IA para Telegram que roda no seu próprio servidor. Mensagens, áudios, fotos, PDFs e publicações encaminhadas são armazenados como arquivos Markdown simples, datados, em um vault compatível com Obsidian. Com o tempo, o sistema cria cartões estruturados para contatos, projetos, decisões e notas.
iva-agent é gratuito? Qual é a licença?
iva-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
iva-agent ainda é mantido?
Manutenção ativa. O último commit de iva-agent foi em 22 de out. de 2026.
Para que posso usar iva-agent?
Relembrar o que foi combinado com um cliente meses atrás. Transformar um áudio longo em uma lista de tarefas, um rascunho de e-mail ou um cartão de reunião. Manter um CRM pessoal de contatos e acompanhamentos dentro do Telegram. Usar um assistente pessoal auto-hospedado que mantém os dados no seu próprio servidor.
Como instalar iva-agent?
Obtenha um token de bot no BotFather Clone o repositório: git clone https://github.com/smixs/iva-agent.git ~/iva Execute o instalador a partir do repositório clonado e responda às perguntas: cd ~/iva && bash install.sh Envie uma mensagem para o seu bot para que o assistente conclua a configuração
Onde consigo iva-agent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/smixs/iva-agent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados