Repolode
emanueleielo

emanueleielo/ciana-parrot

Asistente personal de IA autoalojado que conversa por Telegram, ejecuta tareas programadas y se conecta a servidores MCP y herramientas del host.

Estrellas
77
Forks
19
Issues abiertos
1
Último commit
hace 17 días

¿Qué es?

CianaParrot es un asistente personal de IA autoalojado, creado con DeepAgents, LangChain y LangGraph. El agente se ejecuta dentro de un entorno aislado de Docker y accede al sistema operativo host a través de una pasarela de conexiones seguras. Los usuarios interactúan con él principalmente por Telegram, y el agente también puede crear desde el chat tareas cron, por intervalos y de una sola ejecución.

El proyecto admite varios proveedores de LLM, incluidos Anthropic, OpenAI, Google Gemini, Groq, Ollama, OpenRouter y vLLM. Se pueden configurar varios niveles de modelos para que el agente cambie de modelo durante una conversación. Las conexiones con el host dan acceso a herramientas como Spotify, Reminders, Obsidian y 1Password, y también se pueden conectar servidores MCP externos. Toda la configuración se gestiona desde un único archivo YAML.

Las skills se añaden colocando una carpeta en el directorio de skills, donde se registran automáticamente como herramientas del agente. La memoria se guarda en archivos Markdown que el propio agente puede actualizar. La implementación se basa en Docker e incluye objetivos de make para compilar, ejecutar e iniciar la pasarela; además, un script de instalación se encarga de los requisitos previos y de configurar las claves de API.

Funciones clave

  • 01Conversación con el agente por Telegram, con una arquitectura de canales extensible para añadir otros canales
  • 02Admite Anthropic, OpenAI, Gemini, Groq, Ollama, OpenRouter y vLLM como proveedores de LLM
  • 03Tareas programadas cron, por intervalos y de una sola ejecución que se pueden crear desde el chat
  • 04Conexiones de la pasarela del host con herramientas como Spotify, Reminders, Obsidian y 1Password
  • 05Las skills se registran automáticamente como herramientas del agente al colocarlas en la carpeta de skills
  • 06Integración con servidores MCP y memoria persistente basada en Markdown

Casos de uso

  • Usar un asistente de IA privado en tu propio servidor y escribirle por Telegram
  • Programar recordatorios recurrentes o comprobaciones automáticas que el agente ejecuta por su cuenta
  • Conectar un modelo local mediante Ollama o vLLM y mantener los datos en tu propia infraestructura
  • Ampliar un asistente con skills personalizadas o herramientas MCP externas

Temas

Preguntas frecuentes

¿Qué es ciana-parrot?
Asistente personal de IA autoalojado que conversa por Telegram, ejecuta tareas programadas y se conecta a servidores MCP y herramientas del host. CianaParrot es un asistente personal de IA autoalojado, creado con DeepAgents, LangChain y LangGraph. El agente se ejecuta dentro de un entorno aislado de Docker y accede al sistema operativo host a través de una pasarela de conexiones seguras. Los usuarios interactúan con él principalmente por Telegram, y el agente también puede crear desde el chat tareas cron, por intervalos y de una sola ejecución.
¿ciana-parrot es gratuito? ¿Qué licencia tiene?
ciana-parrot es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ciana-parrot sigue mantenido?
Mantenimiento activo. El último commit de ciana-parrot fue el 5 oct 2026.
¿Para qué puedo usar ciana-parrot?
Usar un asistente de IA privado en tu propio servidor y escribirle por Telegram Programar recordatorios recurrentes o comprobaciones automáticas que el agente ejecuta por su cuenta Conectar un modelo local mediante Ollama o vLLM y mantener los datos en tu propia infraestructura Ampliar un asistente con skills personalizadas o herramientas MCP externas
¿Dónde consigo ciana-parrot?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/emanueleielo/ciana-parrot

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

Proyectos relacionados