ChatLunaLab/chatluna

Что это?

Ключевые возможности

• 01Подключается ко многим провайдерам LLM, включая OpenAI, Gemini, Claude, DeepSeek, Qwen и Ollama.
• 02Предлагает режимы чата, поиска в интернете и агента.
• 03Позволяет настраивать персоны с помощью YAML-файлов пресетов.
• 04Отправляет текстовые, голосовые ответы, отрендеренные изображения или ответы в смешанном формате.
• 05Поддерживает потоковую выдачу ответов и ввод изображений для мультимодальных моделей.
• 06Включает ограничение частоты запросов, чёрный список и MCP-клиент.

Сценарии использования

• Добавить LLM-ассистента в групповой чат QQ, работающий на Koishi.
• Научить бота отвечать на вопросы с помощью актуальных результатов поиска в интернете.
• Настроить разные персоны для разных групповых чатов с помощью файлов пресетов.
• Создать прототип адаптера для новой модели на базе LangChain и Koishi.

Быстрый старт

1. 1

   Установите плагин в проект Koishi (см. руководство по развёртыванию).

2. 2

   Клонируйте ChatLuna в шаблонный проект Koishi с помощью yarn.

   yarn clone ChatLunaLab/chatluna
3. 3

   Перед первым использованием соберите проект.

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

   Запустите шаблонный проект в режиме разработки.

   yarn dev

Что важно знать

• !Разработка проекта идёт медленно; сейчас готовится выпуск v2.
• !Для работы с провайдерами моделей, такими как Claude, понадобится собственный API-ключ; некоторые провайдеры платные.
• !Проект распространяется по лицензии AGPL-3.0 — лицензии с copyleft, которая распространяется и на производные работы.

В подборках

Темы

Частые вопросы

Что такое chatluna?

Плагин для Koishi, который добавляет LLM-чат в QQ и другие боты и поддерживает множество провайдеров моделей, пресеты и разные форматы ответов. ChatLuna — плагин для фреймворка чат-ботов Koishi, который позволяет ботам вести диалоги с помощью больших языковых моделей. Он подключается к множеству провайдеров, включая OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, Qwen, Doubao, Zhipu, Spark, Wenxin, Hunyuan, Ollama и RWKV. Установить плагин можно прямо из Koishi, не редактируя файлы конфигурации.

chatluna можно использовать бесплатно? Какая у него лицензия?

chatluna распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

chatluna всё ещё поддерживается?

Активно поддерживается. Последний коммит в chatluna — 28 окт. 2026 г..

Для чего можно использовать chatluna?

Добавить LLM-ассистента в групповой чат QQ, работающий на Koishi. Научить бота отвечать на вопросы с помощью актуальных результатов поиска в интернете. Настроить разные персоны для разных групповых чатов с помощью файлов пресетов. Создать прототип адаптера для новой модели на базе LangChain и Koishi.

Как установить chatluna?

Установите плагин в проект Koishi (см. руководство по развёртыванию). Клонируйте ChatLuna в шаблонный проект Koishi с помощью yarn.: yarn clone ChatLunaLab/chatluna Перед первым использованием соберите проект.: yarn workspace @root/chatluna-koishi build Запустите шаблонный проект в режиме разработки.: yarn dev

Где скачать chatluna?

Исходный код и инструкции по установке — на GitHub: https://github.com/ChatLunaLab/chatluna