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
Koishiプロジェクト内にプラグインをインストールします(デプロイガイドを参照)
- 2
yarnを使って、KoishiテンプレートプロジェクトにChatLunaをクローンします
yarn clone ChatLunaLab/chatluna - 3
初回使用前に、プロジェクトを一度ビルドします
yarn workspace @root/chatluna-koishi build - 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 の数値は毎日更新されます。
関連プロジェクト
LangChain、LangGraph、LangSmithに関する質問に答えるドキュメントアシスタントエージェント。Next.jsのチャットUIを備えたManaged Deep Agentとして構築されています。
MaiBot(MaiSaka)は、主にQQグループチャットでカジュアルかつ人間らしい会話をする、プラグインシステム搭載のLLMベースの会話エージェントです。
RAGナレッジベース、ビジュアルワークフロー、MCPツールを活用して、エンタープライズ向けAIエージェントを構築できるオープンソースプラットフォーム。
複数のAIプロバイダー、Agents、MCP、Artifacts、マルチユーザー認証に対応したセルフホスト型チャット基盤。