ChatLunaLab/chatluna

O que é?

Recursos principais

• 01Conecta-se a vários provedores de LLM, incluindo OpenAI, Gemini, Claude, DeepSeek, Qwen e Ollama.
• 02Oferece os modos de chat, navegação e agente.
• 03Permite personalizar personas com arquivos de preset YAML.
• 04Gera respostas em texto, fala, imagens renderizadas ou uma combinação desses formatos.
• 05Oferece suporte a respostas em streaming e entrada de imagens para modelos multimodais.
• 06Inclui limitação de taxa, uma lista de bloqueio e um cliente MCP.

Casos de uso

• Adicionar um assistente com LLM a um chat em grupo do QQ operado pelo Koishi.
• Permitir que um bot responda a perguntas com resultados atualizados da busca na web.
• Definir personas diferentes para grupos de chat distintos usando arquivos de preset.
• Criar um protótipo de adapter para um novo modelo usando LangChain e Koishi.

Início rápido

1. 1

   Instale o plugin em um projeto Koishi (consulte o guia de implantação).

2. 2

   Clone o ChatLuna em um projeto de template do Koishi usando yarn.

   yarn clone ChatLunaLab/chatluna
3. 3

   Compile o projeto uma vez antes de usá-lo pela primeira vez.

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

   Inicie o projeto de template em modo de desenvolvimento.

   yarn dev

Antes de usar

• !O desenvolvimento do projeto está lento e uma versão v2 está sendo preparada.
• !Provedores de modelos como Claude exigem sua própria chave de API, e alguns são pagos.
• !O projeto é licenciado sob AGPL-3.0, uma licença copyleft que também se aplica a obras derivadas.

Em coleções

Tópicos

Perguntas frequentes

O que é chatluna?

Plugin de bot para Koishi que adiciona conversas com LLM ao QQ e a outros bots de chat, com vários provedores de modelos, presets e formatos de saída. ChatLuna é um plugin para o framework de chatbot Koishi que permite aos bots conversar usando modelos de linguagem grandes. Ele se conecta a vários provedores, incluindo OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, Qwen, Doubao, Zhipu, Spark, Wenxin, Hunyuan, Ollama e RWKV, e pode ser instalado diretamente pelo Koishi, sem precisar editar arquivos de configuração.

chatluna é gratuito? Qual é a licença?

chatluna é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

chatluna ainda é mantido?

Manutenção ativa. O último commit de chatluna foi em 28 de out. de 2026.

Para que posso usar chatluna?

Adicionar um assistente com LLM a um chat em grupo do QQ operado pelo Koishi. Permitir que um bot responda a perguntas com resultados atualizados da busca na web. Definir personas diferentes para grupos de chat distintos usando arquivos de preset. Criar um protótipo de adapter para um novo modelo usando LangChain e Koishi.

Como instalar chatluna?

Instale o plugin em um projeto Koishi (consulte o guia de implantação). Clone o ChatLuna em um projeto de template do Koishi usando yarn.: yarn clone ChatLunaLab/chatluna Compile o projeto uma vez antes de usá-lo pela primeira vez.: yarn workspace @root/chatluna-koishi build Inicie o projeto de template em modo de desenvolvimento.: yarn dev

Onde consigo chatluna?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ChatLunaLab/chatluna