koris-bot

Koris Assistantは、厳格なTypeScriptで書かれ、Node.js 24以上とpnpmで実行される自律AIエージェントフレームワークです。チャネル、ツール、スキル、MCPサーバーの4つのプラグインファミリーを持つモジュールシステムとして構成されています。プラグインは、コンパニオンハブリポジトリからオンデマンドでダウンロードでき、エージェントを再起動せずにホットロードできます。 チャネルには、Telegram、WhatsApp、対話型ターミナルUI、React 19 Webダッシュボードが含まれます。統一メッセージゲートウェイとセッションマネージャーがこれらすべてを駆動します。フレームワークは、Streamable HTTPを介したModel Context Protocolもサポートし、リモートツールを発見して、LLMツールパイプライン内でserver__toolとして名前空間化します。 音声サポートはローカルです。音声認識はsherpa-onnxを介したWhisperを使用し、音声合成はPiperニューラルボイスを使用し、どちらもポート6006で軽量サイドカーによって提供されます。WhatsAppまたはWeb UIでの音声メモは自動的に文字起こしされ、会話ごとの音声返信モードも利用できます。 メモリとセッションはSQLiteに永続化され、長期的な事実、教訓、要約、セマンティック埋め込み、セッショントラッキング、会話履歴をカバーします。モデルアクセスはマルチプロバイダーです：Ollama、OpenAI互換のプリセット（openai、deepseek、groq、openrouter、xai、mistral、together、gemini、nvidiaなど）、さらにMockプロバイダー。異なるプロバイダーとモデルを役割ごとに割り当てることができ、例えばメインエージェント対バックグラウンドワーカー対埋め込みなどです。 クライアントシェルには、Webダッシュボード、TUI、ネイティブOS WebViewを使用するTauriデスクトップアプリ、Electronデスクトップシェルが含まれます。スケジュールされたcron駆動のバックグラウンドサブエージェント（ハートビートエージェントと呼ばれる）は、自律的なルーチン、メンテナンス、通知を処理します。ツール実行はサンドボックス化されており、ドメイン制限付きHTTP curl、自己ホスト型SearXNG Web検索、課題追跡、ビート管理、ステッカー、カスタムプラグインが含まれます。 プロジェクトは「用事（errands）」機能を文書化しています：Negotiatorエージェントプラグインによって実行される委任された会話で、リクエストしたユーザーに情報を提供しながら、連絡先と目標を追求します。各用事は、ターゲットごとに新しい委任された子セッションを作成し、親セッションID、用事ID、指示をSQLiteメタデータに格納します。コマンドには、用事の一覧表示、承認、返信、再試行、クローズ、キャンセルが含まれます。READMEは、状態遷移、配信回復、キュープロモーション、有効期限の動作、Webポーリングと正確に1回の配信に関する既知の制限事項を説明しています。 セットアップには、依存関係のインストール、サンプル設定ファイルをkoris.jsonにコピーするかWebセットアップウィザードを使用する、設定の検証、ビルドが含まれます。その後、エージェントはWebサービス、TUI、またはデスクトップアプリとして実行できます。オプションのDocker Composeサービスは、SearXNGとオーディオサイドカーを提供します。プロジェクトは、厳格なTypeScriptチェック、Vitestテストスイート、Strykerミューテーションテストを使用し、ISCライセンスの下で提供されると述べています。