Repolode
Enviar
smixs

smixs/iva-agent

Asistente de IA para Telegram autoalojado que organiza notas de voz, fotos y mensajes en una bóveda de memoria Markdown que puede consultar más adelante.

Alternativa open source a:Notion AI

Ver en GitHubSitio web
Estrellas
265
Forks
58
Issues abiertos
24
Último commit
hace 5 horas

¿Qué es?

Iva es un asistente de IA para Telegram que se ejecuta en tu propio servidor. Los mensajes, las notas de voz, las fotos, los PDF y las publicaciones reenviadas se guardan como archivos Markdown de texto sin formato, organizados por fecha, en una bóveda compatible con Obsidian. Con el tiempo, a partir de ellos se crean fichas estructuradas de contactos, proyectos, decisiones y notas.

La memoria se organiza por capas: se conserva la transcripción de cada día palabra por palabra, un resumen nocturno agrupa los días en semanas, meses y años, y un archivo CORE.md breve se incluye en cada prompt. La búsqueda combina BM25 con una reclasificación basada en el grafo de enlaces y ofrece un modo vectorial opcional. El asistente también transcribe voz con Deepgram, describe imágenes mediante el modelo de visión del proveedor de modelos, gestiona tareas y recordatorios, busca en la web a través de varios proveedores y se conecta a Google Workspace mediante la CLI gws.

Iva se instala con un único script de shell en Ubuntu o Debian, y también se describe un instalador para Mac. Es compatible con varios proveedores de modelos, como OpenRouter, Ollama Cloud y las suscripciones de Claude u OpenAI, además de endpoints personalizados compatibles con OpenAI. Un modo userbot opcional puede leer y enviar mensajes desde una cuenta personal de Telegram; el proyecto advierte que esto infringe las condiciones de Telegram y que se usa bajo la responsabilidad del usuario.

Funciones clave

  • 01Transcribe notas de voz con Deepgram y describe fotos mediante la capacidad de visión del modelo.
  • 02Guarda palabra por palabra en Markdown los mensajes de cada día y los resume en resúmenes semanales, mensuales y anuales.
  • 03Mantiene un archivo CORE.md que se incluye en cada prompt para aportar contexto persistente.
  • 04Busca en la memoria con BM25 y una reclasificación basada en el grafo de enlaces, con búsqueda vectorial opcional.
  • 05Gestiona tareas, recordatorios y un resumen diario.
  • 06Se conecta a Gmail, Calendar, Drive, Sheets, Docs y Tasks mediante la CLI gws, y es compatible con servidores MCP y skills.

Casos de uso

  • Recordar lo acordado con un cliente meses atrás.
  • Convertir una nota de voz larga en una lista de tareas, un borrador de correo electrónico o una ficha de reunión.
  • Llevar un CRM personal de contactos y seguimientos desde Telegram.
  • Ejecutar un asistente personal autoalojado que mantiene los datos en tu propio servidor.

Inicio rápido

  1. 1

    Obtén un token de bot de BotFather

  2. 2

    Clona el repositorio

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

    Ejecuta el instalador desde el repositorio clonado y responde a sus preguntas

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

    Envía un mensaje a tu bot para que el asistente pueda terminar la configuración

Antes de usarlo

  • Necesita Node.js 24 o posterior y un servidor que administres tú, por lo que requiere esfuerzo de autoalojamiento.
  • Requiere una clave de API o una suscripción de un proveedor de modelos. Las solicitudes al modelo y de transcripción se envían a API en la nube por las que pagas.
  • La función opcional de userbot infringe las condiciones del servicio de Telegram y puede provocar que limiten o bloqueen tu cuenta.

Temas

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

Preguntas frecuentes

¿Qué es iva-agent?
Asistente de IA para Telegram autoalojado que organiza notas de voz, fotos y mensajes en una bóveda de memoria Markdown que puede consultar más adelante. Iva es un asistente de IA para Telegram que se ejecuta en tu propio servidor. Los mensajes, las notas de voz, las fotos, los PDF y las publicaciones reenviadas se guardan como archivos Markdown de texto sin formato, organizados por fecha, en una bóveda compatible con Obsidian. Con el tiempo, a partir de ellos se crean fichas estructuradas de contactos, proyectos, decisiones y notas.
¿iva-agent es gratuito? ¿Qué licencia tiene?
iva-agent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿iva-agent sigue mantenido?
Mantenimiento activo. El último commit de iva-agent fue el 22 oct 2026.
¿Para qué puedo usar iva-agent?
Recordar lo acordado con un cliente meses atrás. Convertir una nota de voz larga en una lista de tareas, un borrador de correo electrónico o una ficha de reunión. Llevar un CRM personal de contactos y seguimientos desde Telegram. Ejecutar un asistente personal autoalojado que mantiene los datos en tu propio servidor.
¿Cómo se instala iva-agent?
Obtén un token de bot de BotFather Clona el repositorio: git clone https://github.com/smixs/iva-agent.git ~/iva Ejecuta el instalador desde el repositorio clonado y responde a sus preguntas: cd ~/iva && bash install.sh Envía un mensaje a tu bot para que el asistente pueda terminar la configuración
¿Dónde consigo iva-agent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/smixs/iva-agent

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados