AIOS Monorepo

AIOS モノレポ

このリポジトリには、フロントエンドのデスクトップアプリケーションとバックエンドの LangGraph サーバーに分かれた、AIOS（Artificial Intelligence Operating System）プロジェクトが含まれています。

プロジェクト構成

• /aios-desktop-app：Electron ベースのフロントエンドアプリケーションが含まれています。
• /aios-langgraph-server：Python ベースの LangGraph バックエンドサーバーが含まれています。

前提条件

作業を始める前に、以下がインストールされていることを確認してください。

• Node.js（LTS バージョンを推奨）と npm：デスクトップアプリケーション用です。
• Python（バージョン 3.12.4 を推奨）と pip：バックエンドサーバー用です。
• uv：Python パッケージマネージャーです。

セットアップと起動

各プロジェクトは、別々のターミナルセッションでセットアップして起動する必要があります。

1. AIOS LangGraph サーバー（バックエンド）

バックエンドサーバーは AI の中核機能を提供し、それらを API 経由で公開します。デスクトップアプリケーションはこの API を利用します。

セットアップ：

1. バックエンドディレクトリに移動します。

   cd aios-langgraph-server
   

2. 環境設定ファイルを作成します。 .env.example を .env という名前の新しいファイルにコピーします。

   cp .env.example .env
   

   次に、.env を開き、必要な環境固有の変数（API キーやデータベースの認証情報など）を設定します。
3. uv を使用して Python 仮想環境を作成し、有効化します。

   uv venv
   # On macOS/Linux:
   source .venv/bin/activate
   # On Windows:
   .venv\Scripts\activate
   

4. uv を使用してプロジェクトの依存関係をインストールします（pyproject.toml が使用されます）。

   uv sync
   

サーバーの起動：

1. uv の仮想環境が有効になっていることを確認します。
2. 開発モードで LangGraph サーバーを起動します。

   langgraph dev --no-browser
   

   このコマンドは、通常、ブラウザーウィンドウを開かずにサーバーを起動します。ターミナルの出力でサーバーアドレスを確認してください（通常は http://localhost:2024 です）。

2. AIOS デスクトップアプリ（フロントエンド）

フロントエンドは、AIOS を操作するためのユーザーインターフェースを提供する Electron アプリケーションです。

セットアップ：

1. フロントエンドディレクトリに移動します。

   cd aios-desktop-app
   

2. 環境設定ファイルを作成します。 .env.example を .env という名前の新しいファイルにコピーします。

   cp .env.example .env
   

   次に、.env を開き、デスクトップアプリケーションに必要な環境固有の変数を設定します。
3. Node.js の依存関係をインストールします。

   npm install
   

   postinstall スクリプトによって electron-builder install-app-deps が自動的に実行され、Electron 固有のネイティブ依存関係がすべて正しくセットアップされます。

アプリの起動（開発モード）：

1. 開発サーバーを起動します。

   npm run dev
   

   ホットリロードが有効な状態で Electron アプリケーションが起動し、開発中の変更をリアルタイムで確認できます。

開発ワークフロー

1. 最初に aios-langgraph-server を起動します。
2. 次に aios-desktop-app を起動します。
3. デスクトップアプリは、ローカルで実行中のバックエンドサーバーに接続します。

本番環境向けのビルド

aios-desktop-app：

各プラットフォーム（Windows、macOS、Linux）向けに Electron アプリをビルドする方法については、aios-desktop-app/package.json のスクリプトを参照してください。

cd aios-desktop-app
npm run build:win
npm run build:mac
npm run build:linux

aios-langgraph-server：

LangGraph サーバーは通常、Python の Web アプリケーションとしてデプロイされます。デプロイ方法はさまざまで（Docker、サーバーレス関数、従来型の ASGI サーバーホスティングなど）、langgraph export コマンドを使用して LangGraph アプリケーションをパッケージ化できます。デプロイの詳細は、選択したホスティング環境によって異なります。

---

この README では、開始するための基本的な手順を説明しています。各コンポーネントの詳細については、各プロジェクトディレクトリ内のドキュメント（存在する場合）を参照するか、それぞれの package.json と pyproject.toml を確認してください。