Yuki
Yuki es un agente social de IA de código abierto para chats de grupos QQ, diseñado para mantener una identidad persistente con memoria a largo plazo, relaciones sociales y participación autónoma opcional.
Ficha actualizada 24 sept 2026, 5:32 · upstream 24 sept 2026, 5:20 · release v3.8.3
Qué es Yuki
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Yuki es un agente social de inteligencia artificial de código abierto diseñado para operar dentro de chats de grupos privados de QQ. Su objetivo principal es explorar cómo puede existir una vida digital persistente en escenarios sociales reales, recordando personas y experiencias compartidas a lo largo del tiempo.
El sistema se basa en una arquitectura robusta que utiliza Node.js, FastAPI y Python, gestionada mediante Docker Compose. Cuenta con un entorno de trabajo persistente opcional que permite ejecutar scripts, instalar dependencias y mantener archivos entre sesiones, facilitando la realización de tareas complejas que requieren continuidad más allá del chat.
La gestión de memoria es central en su diseño, diferenciando entre datos a corto plazo (short_state) y memoria a largo plazo para hechos estables. Soporta procesamiento multimodal mediante reconocimiento de voz (ASR) y síntesis de voz (TTS), además de capacidades de búsqueda externa y ejecución de herramientas.
- Mantener una identidad social coherente en grupos de chat, recordando interacciones pasadas y preferencias de usuarios para personalizar respuestas a largo plazo.
- Ejecutar tareas automatizadas o scripts complejos dentro del entorno persistente del bot, como análisis de datos o gestión de archivos, iniciados desde el chat.
- Procesar y responder a contenido multimodal, incluyendo imágenes, documentos PDF/DOCX y archivos de audio, extrayendo información relevante para la conversación.
- Gestionar operaciones sociales en QQ, como enviar mensajes masivos, estructurar menciones (@) o consultar la lista de miembros del grupo bajo supervisión.
- Arquitectura modular con soporte nativo para Docker Compose y despliegue mediante scripts de instalación automáticos.
- Sistema de memoria persistente que separa datos a corto plazo de hechos estables, permitiendo corrección y borrado explícito de información.
- Entorno de trabajo persistente opcional con herramientas preinstaladas (Bash, Python, Node.js) para ejecutar tareas fuera del ciclo de vida del chat.
- API de plugins versionada (Plugin API 3.0) que permite extender funcionalidades sin modificar el núcleo del agente.
- No incluye una interfaz web de gestión (WebUI) ni una API HTTP pública para control externo en la versión actual.
- El entorno persistente requiere un host Linux con gVisor y un gestor separado (Yuki Manager), no viene incluido en el paquete básico.
- La participación autónoma en grupos de chat está actualmente en fase de validación y su comportamiento a largo plazo no está completamente estabilizado.
- Las capacidades de búsqueda externa dependen de proveedores externos como Tavily o DeepSeek, requiriendo configuración manual de claves API.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Linux amd64 o Windows con Docker Desktop. Necesita un servicio de modelos compatible con Chat Completions o Responses y al menos un gateway QQ (NapCat o SnowLuma). Para el entorno persistente es obligatorio usar gVisor. El despliegue se realiza mediante docker compose, ejecutando primero la inicialización de la base de datos antes de arrancar los servicios.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.