KIAgent

KIAgent

あなた専用の AI ブレイン — ローカルで動作するオープンソースで、MCP に対応。

ウェブサイト · ダウンロード · アーキテクチャのドキュメント

あらゆる企業が、会社のブレイン、つまり組織の知識をすべて取り込み、AI が実際のコンテキストに基づいて回答し、行動できるようにするナレッジレイヤーを構築しています。KIAgent は、あなた個人のためのそのレイヤーです。 会社のブレインは他社のクラウド上にあり、雇用主のものです。一方、あなた専用の AI ブレインは自分のマシン上で動作し、好きな AI と連携し、いつまでもあなたのものです。

具体的には、KIAgent は個人データ（メール、ドキュメント、チャット、メモなど）を自分のマシン上で取り込み、ローカルデータベースに保存して、MCP を通じて AI アシスタントに提供するデスクトップアプリです。取り込み、解析、OCR、画像認識はすべてローカルで実行されます。llama.cpp を利用したオンデバイス推論により、データがマシンの外に出ることなく、AI アシスタントがあなたの世界を把握できます。

KIAgent の中核にあるのはプラットフォームです。ホストの機能（MCP、データベース、ローカル LLM、ファイルシステム、ウェブアクセス）を少数揃え、取り込みエンジンで連携させています。さらに、サンドボックス化されたコネクターがこれらの機能を使って新しいデータソースを取り込めるようにする、プラグイン／拡張機能システムも備えています。

flowchart TB
    GMAIL(["Gmail"])
    DRIVE(["Drive"])
    SLACK(["Slack"])
    NOTION(["Notion"])
    MORE(["…"])

    PLUGINS["Plugins / extensions"]

    WEB["Web"]
    LLM["Local LLM"]
    FS["Filesystem"]
    DB[("DB")]
    MCP["MCP"]

    GMAIL --> PLUGINS
    DRIVE --> PLUGINS
    SLACK --> PLUGINS
    NOTION --> PLUGINS
    MORE --> PLUGINS
    PLUGINS <--> WEB
    PLUGINS <--> LLM
    PLUGINS <--> FS
    PLUGINS <--> DB
    DB --> MCP

    classDef service fill:#e8f0fe,stroke:#4285f4,color:#1a3c78
    classDef core fill:#e6f4ea,stroke:#34a853,color:#1e4620
    classDef hub fill:#fce8e6,stroke:#ea4335,color:#7a1c14,stroke-width:2px

    class GMAIL,DRIVE,SLACK,NOTION,MORE service
    class WEB,LLM,FS,DB,MCP core
    class PLUGINS hub

プラグインが中心的な役割を果たします。それぞれがサードパーティーのサービス（Gmail、Drive、Slack、Notion など）またはローカルファイルシステムに接続し、データを取り込んでローカル LLM で処理し、データベースに格納します。その後、MCP がデータベースの内容を AI アシスタントに提供します。アクセスは仲介され、権限によって制御されます。プラグインがこれらの機能に直接アクセスすることはありません。

このリポジトリ：kiagent-core

このリポジトリは、VS Code と Code-OSS と同じ考え方で開発された、KIAgent の基盤となる MIT ライセンスのコアです。

• kiagent-core（このリポジトリ） — オープンソースのコアです。npm run package:oss を実行すると、MIT ライセンスのもとで実行・再配布できる、ブランド表記のない kiagent-core ビルドが生成されます。
• KIAgent — このコアをもとに構築され、ブランド表記と署名が付与された製品です。localkiagent.com/download から配布されています。

OAuth 対応ソース（Gmail、Microsoft）は、ビルド時に環境変数からクライアント認証情報を読み込みます。.env.example および CI シークレットを参照してください。フォークや OSS ビルドでは、独自の OAuth クライアント ID を用意してください。

主なコンポーネント

• 取り込みエンジン（src/main/core/engine）— 一定間隔でソースからバッチを取得し、生データ（メール、PDF、画像）をインデックス付きドキュメントに変換して、ストアに登録します。組み込みソースは src/main/sources にあります（Gmail、IMAP、Microsoft 365、ローカルフォルダー）。
• データベース（src/main/core/store、src/main/db）— ドキュメント、メタデータ、検索インデックスを保持する SQLite コーパス（better-sqlite3）です。アプリが書き込み、MCP プロセスが読み取ります。
• MCP サーバー（src/main/core/mcp、src/main/mcp）— 1 つのツールレジストリを共有する 2 つのトランスポートを通じて、AI アシスタントにコーパスを公開します。アプリ内の HTTP サーバーと、Claude Desktop などのクライアントが直接起動する、単独で動作する stdio エントリーポイントです。
• ローカル LLM（src/main/providers/local-llm、src/main/providers/apple-vision）— バンドルされた llama.cpp サーバーによるオンデバイス推論（バックエンドの自動検出、厳選されたモデル階層）に加え、スキャンしたドキュメントや画像向けのネイティブ OCR／ビジョンヘルパーを提供します。
• ファイルシステム — ローカルフォルダーの取り込み、モデルの保存、変換ワーカー用の一時ワークスペース（src/main/workers、src/main/converter）。
• Web — ソース API への送信 HTTP 通信、OAuth フロー（src/main/auth、src/main/platform/oauth-providers.ts）、マーケットプレイスからのダウンロード。
• プラグイン／拡張機能システム（src/main/platform、src/main/marketplace）— コネクターは、マニフェストで宣言され、権限によって制限されたプラットフォーム（ソース、認証、ストレージ、ネットワーク）へのアクセス権を持ち、分離されたホストプロセス内で実行されます。GitHub を基盤とするマーケットプレイスで、検索、インストール、更新を行います。さらに、製品ビルドでファーストパーティ拡張機能をアプリパッケージ内に同梱できる、特権付きの第 2 階層もあります。バンドル型／unsafe.mainProcess 階層や product.json を含む全体像については、docs/architecture/extension-platform.md をご覧ください。
• レンダラー（src/renderer）— React UI です。ソースのセットアップ、マーケットプレイス、MCP 接続状況、設定、ログを扱います。

開発

npm install
npm start          # run in development (hot reload)

その他の便利なスクリプト：

npm test                 # jest test suites
npm run lint             # eslint + prettier
npm run typecheck        # tsc, no emit
npm run package          # build a distributable
npm run package:oss      # build an unbranded kiagent-core distributable
npm run vendor:inference # fetch llama.cpp server + build vision helper

リポジトリの構成

src/main       Electron main process: engine, store, MCP, platform, sources, providers
src/renderer   React UI (screens: Sources, Marketplace, Connection, Settings)
src/shared     Contracts and UI primitives shared across processes
concept/       Types-only blueprint for the core redesign
docs/          Design specs and implementation plans
native/        Native helper sources (vision/OCR)
scripts/       Build and vendoring scripts

MCP ディレクトリ

KIAgent は com.localkiagent/kiagent として公式 MCP レジストリに公開されており（server.json を参照）、Glama にも掲載されています。

謝辞

KIAgent のオンデバイス推論は、Georgi Gerganov が作成し、ggml-org コミュニティがメンテナンスする llama.cpp（MIT ライセンス）によって実現しています。アプリには、公式 llama.cpp リリースのビルド済み llama-server バイナリが同梱されています（ビルド時に npm run vendor:inference で取得します）。コンシューマー向けハードウェア上で高性能なモデルをプライバシーを保って実行できるのは、彼らの貢献があってこそです。ありがとうございます。

ライセンス

MIT — LICENSE をご覧ください。