Repolode
Enviar
ChatLunaLab

ChatLunaLab/chatluna

Un plugin de Koishi que añade chat con LLM a QQ y otros bots de chat, con numerosos proveedores de modelos, presets y varios formatos de salida.

Ver en GitHubSitio web
Estrellas
445
Forks
51
Issues abiertos
6
Último commit
hace 10 días

¿Qué es?

ChatLuna es un plugin para el framework de chatbots Koishi que permite a los bots mantener conversaciones impulsadas por modelos de lenguaje grandes. Se conecta con varios proveedores, como OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, Qwen, Doubao, Zhipu, Spark, Wenxin, Hunyuan, Ollama y RWKV, y se puede instalar directamente desde Koishi sin editar archivos de configuración.

Además del chat de texto, ofrece tres modos (chat, navegación y agente), personalidades personalizadas definidas en archivos preset YAML y limitación de frecuencia con una lista de bloqueo. Las respuestas pueden ser texto, voz, imágenes renderizadas o una combinación de estos formatos. El plugin también admite respuestas en streaming, entrada de imágenes para modelos multimodales, memoria a largo plazo y un cliente MCP. La búsqueda web para modelos está disponible a través de Google, Bing, DuckDuckGo y Tavily.

El proyecto está dirigido a quienes administran bots de QQ y otros bots basados en Koishi y quieren añadir un asistente LLM a chats grupales o privados, así como a desarrolladores que quieran ampliarlo con nuevos adaptadores basados en LangChain y la API de Koishi.

Funciones clave

  • 01Se conecta con numerosos proveedores de LLM, como OpenAI, Gemini, Claude, DeepSeek, Qwen y Ollama.
  • 02Ofrece modos de chat, navegación y agente.
  • 03Permite personalizar personalidades mediante archivos preset YAML.
  • 04Genera respuestas de texto, voz, imágenes renderizadas o una combinación de estos formatos.
  • 05Admite respuestas en streaming y entrada de imágenes para modelos multimodales.
  • 06Incluye limitación de frecuencia, una lista de bloqueo y un cliente MCP.

Casos de uso

  • Añadir un asistente LLM a un chat grupal de QQ gestionado con Koishi.
  • Permitir que un bot responda preguntas con resultados de búsqueda web actualizados.
  • Asignar personalidades distintas a diferentes grupos de chat mediante archivos preset.
  • Crear un prototipo de un nuevo adaptador de modelos basado en LangChain y Koishi.

Inicio rápido

  1. 1

    Instala el plugin dentro de un proyecto Koishi (consulta la guía de despliegue).

  2. 2

    Clona ChatLuna en un proyecto de plantilla de Koishi con yarn.

    yarn clone ChatLunaLab/chatluna
  3. 3

    Compila el proyecto una vez antes de usarlo por primera vez.

    yarn workspace @root/chatluna-koishi build
  4. 4

    Inicia el proyecto de plantilla en modo de desarrollo.

    yarn dev

Antes de usarlo

  • El desarrollo del proyecto avanza lentamente y se está preparando una versión v2.
  • Los proveedores de modelos como Claude requieren tu propia clave de API; algunos son de pago.
  • Está bajo la licencia AGPL-3.0, una licencia copyleft que también se aplica a las obras derivadas.

En colecciones

Chatbots de IA y clientes de chat

Temas

#chatbot#llm#koishi#plugin#typescript#langchain#qq-bot#multi-model#agent#ai

Preguntas frecuentes

¿Qué es chatluna?
Un plugin de Koishi que añade chat con LLM a QQ y otros bots de chat, con numerosos proveedores de modelos, presets y varios formatos de salida. ChatLuna es un plugin para el framework de chatbots Koishi que permite a los bots mantener conversaciones impulsadas por modelos de lenguaje grandes. Se conecta con varios proveedores, como OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, Qwen, Doubao, Zhipu, Spark, Wenxin, Hunyuan, Ollama y RWKV, y se puede instalar directamente desde Koishi sin editar archivos de configuración.
¿chatluna es gratuito? ¿Qué licencia tiene?
chatluna es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿chatluna sigue mantenido?
Mantenimiento activo. El último commit de chatluna fue el 28 oct 2026.
¿Para qué puedo usar chatluna?
Añadir un asistente LLM a un chat grupal de QQ gestionado con Koishi. Permitir que un bot responda preguntas con resultados de búsqueda web actualizados. Asignar personalidades distintas a diferentes grupos de chat mediante archivos preset. Crear un prototipo de un nuevo adaptador de modelos basado en LangChain y Koishi.
¿Cómo se instala chatluna?
Instala el plugin dentro de un proyecto Koishi (consulta la guía de despliegue). Clona ChatLuna en un proyecto de plantilla de Koishi con yarn.: yarn clone ChatLunaLab/chatluna Compila el proyecto una vez antes de usarlo por primera vez.: yarn workspace @root/chatluna-koishi build Inicia el proyecto de plantilla en modo de desarrollo.: yarn dev
¿Dónde consigo chatluna?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ChatLunaLab/chatluna

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

Proyectos relacionados