Eigentで完全ローカルなAIワークフォースを構築するためのガイド

強力なAIツールを導入したいと考えるとき、多くの人が重要な課題に直面します。それは、機密データのセキュリティを損なうことなく、その能力を最大限に引き出すにはどうすればよいか、という点です。

多くのプラットフォームはすべてをクラウドに送信します。最初は便利に感じますが、顧客レコード、財務データ、社内IPを扱うようになると、すぐに懸念が生まれます。マルチエージェントシステムの力は欲しい。でも、同時にプライバシー、制御、そしてすべてを自分のマシン上で実行できる自由も欲しいはずです。

そこで登場するのがEigentです。Eigent open source coworkを使えば、完全にローカルなマルチエージェントワークフォースを、自分のインフラ上だけで構築できます。

Eigentとは？

Eigentは、ローカルファーストのマルチエージェントデスクトップアプリケーションです。データを外部サーバーへ送信する代わりに、すべてを自分のコンピューター上で実行します。何が起きているのかを完全に把握でき、ファイル、認証情報、ログが自分の手元に残る安心感を得られます。

これは、自分専用のAIワークフォースを構築するようなものだと考えてください。さまざまなスキルを持つエージェントを立ち上げられます。たとえば、Webをくまなく探す検索エージェント、コードを実行する開発者エージェント、ファイルの作成や編集を行うドキュメントエージェント、さらには画像や音声を扱うマルチモーダルエージェントまで可能です。Eigentがそれらを調整するので、エージェント同士が並列にタスクを処理し、必要に応じて引き継ぎ、完成度の高い成果を届けられます。

このガイドでは、それをローカルで正確にセットアップする方法を紹介します。最後には、あなたの方針に合わせてエージェントが連携できる状態で、デスクトップ上でEigentが動作するようになります。

前提条件

Node.js（v18以上）とnpm: EigentはNode/Electronアプリケーションです。まだインストールしていない場合は、Node.js（18〜22推奨）をインストールしてください。 メモリとハードウェア: 少なくとも8 GBのRAMを推奨します。外部APIに接続する場合、EigentはCPUのみでも動作できます。ローカルで大規模モデル推論を行う場合は、NVIDIA RTXなどの高性能GPUがあると便利です。 オペレーティングシステム: EigentはWindowsとmacOSをサポートしています。 Docker: Dockerをインストールし、起動していることを確認してください。https://docs.docker.com/get-docker/ ‍

1. リポジトリをクローンしてPostgreSQLバックエンドを起動する

Eigentのリポジトリをクローンして依存関係をインストールします。

git clone https://github.com/eigent-ai/eigent.git
cd eigent

serverディレクトリに移動してDockerを起動します。

cd server
cp .env.example .env
docker compose up -d

これで2つのコンテナが起動します。

PostgreSQLデータベース（Eigentのデータストア） Eigent APIサーバー APIはどちらもローカルマシン上のlocalhost:3001で動作します。デフォルトでは、DockerがPostgreSQL用のボリュームを作成するため、データベースファイルはディスクに保存されます。

2. ローカルデータ保存を確認する

この時点で、すべてがローカルで動作しています。PostgreSQLコンテナ（eigent_postgres）がデータベースを保持しています。Dockerコンテナ一覧を表示するか、コンテナ内でpsqlのようなツールを使えば確認できます。Eigentが行うすべての処理（エージェントメッセージ、ユーザーデータ、タスクログなど）は、このローカルのPostgresインスタンスに書き込まれます。データがマシンの外に送信されることはありません。

すべてのEigentデータは、ローカルのDocker化されたPostgreSQLデータベースに保存されます。

これにより、設計段階からプライバシーが確保されます。ドキュメントに記載されているとおり、自己ホストの大きな利点の1つはデータプライバシーです。機密データを自分のインフラ内に保持できます。実際、このセットアップを使えば、ワークスペース情報やログイン情報がローカルネットワークの外に出ることはありません。Eigentはデフォルトで完全ローカルなので、データがその場に留まっていることを監査し、安心して利用できます。

3. ローカルプロキシ用に.env.developmentを変更する

次に、フロントエンドがクラウドサービスではなくローカルバックエンドを使うように指示する必要があります。プロジェクトルート(eigent/.env.development)で、ローカルプロキシ設定を有効にします。.env.developmentをテキストエディタで開き、次の内容が含まれていることを確認してください。

VITE_BASE_URL=/api
VITE_PROXY_URL=http://localhost:3001
VITE_USE_LOCAL_PROXY=true

VITE_USE_LOCAL_PROXY=trueを設定し、VITE_PROXY_URLをhttp://localhost:3001に向けることで、フロントエンドはすべてのAPI呼び出しをローカルのDockerバックエンドに送信するようになります。

これらの行の先頭にある#やコメント記号を必ず削除し、設定が有効になるようにしてください。この構成では、フロントエンドアプリは外部のデモAPIではなく、ローカルサーバーへリクエストをプロキシします。

4. フロントエンドアプリを実行する

次にリポジトリのルートに戻り、JavaScriptの依存関係をインストールしてから開発サーバーを起動します。

cd ..
npm install
npm run dev

これでEigentのフロントエンドがローカルで起動します。デフォルトではhttp://localhost:3000で動作します。.envの変更により、フロントエンドはhttp://localhost:3001のAPIにアクセスします。すべて同じマシン内で完結します。

> eigent@* dev
> vite

  VITE vX.X.X  ready in Y ms

  ➜  Local:   http://localhost:3000/

ここでは特別なクラウド認証情報は必要ありません。通常のNode開発ビルドと同じです。

5. Eigent UIにローカルでアクセスする

Eigentのログイン画面がローカルで提供され、読み込まれます。サインインは必要ですが、このインスタンスは自己ホスト型であり、外部サービスは関与しません。

このログインはあくまでローカルアプリ用です。認証情報とデータは、起動したローカルのPostgresデータベースに保存され、クラウドサーバーには保存されません。UI上はOAuth風のログインに見えますが、認証情報とユーザーデータはすべてあなたのマシン上にあります。ドキュメントでも、このローカルファーストの構成が強調されています。「Your data stays on your own device, addressing privacy and security concerns」。ログインすると、メインダッシュボードに移動し、カスタムエージェントの作成、ワークフローの定義、ツールの設定ができます。

たとえば、ツール/設定ページでは、組み込みの連携機能（Web検索、Google docs、Slackなど）を有効または無効にできます。また、モデル選択画面では、使用したいLLMを選択または設定できます。ここから先のすべて、つまりエージェントメッセージ、ツールの出力、ナレッジベースなどは、明示的にエクスポートしない限り、PostgreSQLデータベースとローカルファイルシステムに残ります。

Eigent UIでは、統合ツール（Slack、Web検索など）をローカルインスタンスで設定できます。ローカルのEigentセットアップで、エージェントに使用するモデルやAPIを選択してください。

注: ローカルモードで実行する場合、モデル用のAPIキーやエンドポイントはユーザー自身で設定する必要があります。

チュートリアル全編を見る

視覚的なガイドをご希望ですか？Dockerの起動からEigentへのローカルログインまで、全工程を順番にたどるステップバイステップの解説を収録しています。

チュートリアルリンク: YouTubeで見る