Repolode
ChatLunaLab

ChatLunaLab/chatluna

QQなどのチャットボットにLLMチャット機能を追加するKoishiプラグイン。多数のモデルプロバイダー、プリセット、複数の出力形式に対応。

スター
445
フォーク
51
未解決の Issue
6
最終コミット
10 日前

これは何?

ChatLunaは、ボットが大規模言語モデルを使って会話できるようにする、チャットボットフレームワークKoishi向けのプラグインです。OpenAI、Azure OpenAI、Google Gemini、Claude、DeepSeek、Qwen、Doubao、Zhipu、Spark、Wenxin、Hunyuan、Ollama、RWKVなど、さまざまなプロバイダーに接続できます。設定ファイルを編集せず、Koishiから直接インストールできます。

通常のチャットに加えて、チャット・ブラウジング・エージェントの3つのモード、YAMLのプリセットファイルで定義するカスタムペルソナ、レート制限とブロックリストを備えています。返信はテキスト、音声、レンダリング画像、またはそれらを組み合わせた形式で出力でき、ストリーミング応答、マルチモーダルモデル向けの画像入力、長期記憶、MCPクライアントにも対応しています。モデル向けのWeb検索にはGoogle、Bing、DuckDuckGo、Tavilyを利用できます。

このプロジェクトは、グループチャットや個別チャットでLLMアシスタントを使いたい、QQなどのKoishiベースのボット運用者を対象としています。また、LangChainとKoishi APIを使った新しいアダプターで機能を拡張したい開発者にも向いています。

主な機能

  • 01OpenAI、Gemini、Claude、DeepSeek、Qwen、Ollamaなど、多数のLLMプロバイダーに接続できます。
  • 02チャット、ブラウジング、エージェントの各モードを利用できます。
  • 03YAMLのプリセットファイルでペルソナをカスタマイズできます。
  • 04テキスト、音声、レンダリング画像、またはそれらを組み合わせた形式で返信できます。
  • 05ストリーミング応答と、マルチモーダルモデル向けの画像入力に対応しています。
  • 06レート制限、ブロックリスト、MCPクライアントを備えています。

ユースケース

  • Koishiで運用するQQグループチャットにLLMアシスタントを追加する。
  • Web検索の最新結果を使ってボットに質問へ回答させる。
  • プリセットファイルを使い、チャットグループごとに異なるペルソナを設定する。
  • LangChainとKoishiを基盤に、新しいモデルアダプターを試作する。

クイックスタート

  1. 1

    Koishiプロジェクト内にプラグインをインストールします(デプロイガイドを参照)

  2. 2

    yarnを使って、KoishiテンプレートプロジェクトにChatLunaをクローンします

    yarn clone ChatLunaLab/chatluna
  3. 3

    初回使用前に、プロジェクトを一度ビルドします

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

    テンプレートプロジェクトを開発モードで起動します

    yarn dev

使う前に知っておきたいこと

  • プロジェクトの開発はゆっくり進んでおり、v2リリースの準備中です。
  • Claudeなどのモデルプロバイダーを利用するには、ご自身のAPIキーが必要です。また、一部は有料です。
  • AGPL-3.0ライセンスが適用されます。これはコピーレフトライセンスで、派生物にも適用されます。

収録されている特集

トピック

よくある質問

chatluna とは?
QQなどのチャットボットにLLMチャット機能を追加するKoishiプラグイン。多数のモデルプロバイダー、プリセット、複数の出力形式に対応。 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 の最終コミットは 2026年10月28日 です。
chatluna は何に使えますか?
Koishiで運用するQQグループチャットにLLMアシスタントを追加する。 Web検索の最新結果を使ってボットに質問へ回答させる。 プリセットファイルを使い、チャットグループごとに異なるペルソナを設定する。 LangChainとKoishiを基盤に、新しいモデルアダプターを試作する。
chatluna のインストール方法は?
Koishiプロジェクト内にプラグインをインストールします(デプロイガイドを参照) yarnを使って、KoishiテンプレートプロジェクトにChatLunaをクローンします: yarn clone ChatLunaLab/chatluna 初回使用前に、プロジェクトを一度ビルドします: yarn workspace @root/chatluna-koishi build テンプレートプロジェクトを開発モードで起動します: yarn dev
chatluna はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ChatLunaLab/chatluna

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

LLM、プラグイン、エージェントツールをQQ、Telegram、Slack、DiscordなどのIMアプリに接続する、オープンソースのエージェント型チャットボットプラットフォーム。

4.6万+1060 今週3410PythonAGPL-3.0活発にメンテナンス更新 一昨日