ZJU-REAL/HugAgentOS

HugAgentOS – エンタープライズグレードのエージェントオペレーティングシステム

概要 – HugAgentOSは、情報の取得、ファイルの操作、コードの実行、エンドツーエンドのタスク遂行が可能なAIエージェントを実行できる、オープンソースでセルフホスト型のプラットフォームです。コントロールプレーンとして機能するドメインオントロジーを中心に構築されており、システムがビジネスルールを強制し、意思決定を追跡し、権限を管理できるようにします。

主な機能

機能	内容
チャットと計画	リアルタイムSSEストリーミング、ReActスタイルのツールオーケストレーション、引用付きの計画モード実行、再開可能な実行。
プライベートRAG	ドキュメントチャンク化、ハイブリッドベクトル・キーワード検索、オプションのリランキング、ユーザーごとの分離。
サブエージェント	ルーティングや @ メンションでアクセス可能な、役割を持つ個人用「アシスタント」エージェント。
MCPツールエコシステム	内蔵のWeb検索、ページ取得、知識検索、バッチ実行、自動化、スキルマーケットプレイス。
エージェントスキル	Python/TSで記述された再利用可能なスキル定義でコアエージェントを拡張。
自動化 / バッチ	自然言語タスクのスケジュール設定、スプレッドシート、Wordドキュメント、ファイルリストに対するプロセス実行。
グループチャットボット	飛書（Feishu）、釘釘（DingTalk）、企業微信（WeCom）に接続し、チームチャンネルでの読み取りと返信が可能。
サンドボックス実行	サブプロセスまたは軽量コンテナでコードを実行し、グラフ、レポート、Webページなどを生成。
3層メモリ	リレーショナルDBに保存されるプロファイル、オプションのMilvusベクトルメモリ、オプションのNeo4jグラフメモリ。
個人の進化	メモリ、スキル、オントロジーの変更はバージョン管理され、人間の承認が必要で、ロールバックも可能。
ワークスペースとデータキャンバス	プロジェクト、フォルダ、アーティファクトセンター、会話内データエディタ。

実行方法

• ワンコマンドインストーラー (Linux/macOS/WSL2) – リポジトリをプルし、仮想環境を作成し、Reactフロントエンドをビルドして 127.0.0.1:3001 でサービスを開始します。SQLiteとプロセス内サンドボックスを使用し、個人利用に最適です。
• Docker-Compose – PostgreSQL、Redis、オプションのMilvus/Neo4j、および本番環境向けの分離と永続化のためのサンドボックスコンテナを起動します。http://localhost:3002 でアクセス可能です。

どちらの方法もOpenAI互換またはローカルホストのLLMが必要です。UIの Settings → System → Model services からモデルを設定できます。

アーキテクチャの概要

• エージェントランタイム – AgentScope 2.0、ReAct、Model Context Protocol (MCP) 上に構築。
• バックエンド – FastAPI + SQLAlchemy + Alembic (Python)。
• フロントエンド – React 19 + TypeScript + Vite + Ant Design。
• 状態とストレージ – SQLiteまたはPostgreSQL、オプションでRedis、Milvus、Neo4j、またはベクトル/グラフメモリ用の mem0。
• デプロイメント – シングルバイナリインストーラー、Docker Compose、またはカスタムNginxフロントエンドデプロイメント。

なぜ重要か

• モデル非依存 – コード変更なしでクラウドまたはオンプレミスのLLMを切り替え可能。
• 信頼性の高い実行 – 計画はオントロジーで定義されたルールに対してチェックされ、違反は黙って実行されるのではなく証拠とともに報告されます。
• トレーサビリティ – すべての承認、拒否、結果が記録され、バージョン管理されたオントロジーの更新とロールバックが可能。
• データはオンプレミスに保持 – すべてのデータベースとファイルストアは自身のインフラストラクチャ上で実行されます。

エディション

• コミュニティ版 (本リポジトリ) – 完全な個人エージェントスタック、Apache 2.0ライセンスでオープンソース。
• エンタープライズ版 – マルチテナントガバナンス、SSO、組織全体のスキルレビュー、永続サンドボックス、課金、コラボレーションツールを追加（ソースコードはここには含まれません）。

はじめに

# ワンコマンドインストール (Linux/macOS/WSL2)
curl -fsSL https://raw.githubusercontent.com/ZJU-REAL/HugAgentOS/main/install.sh | bash
# 後で開始する場合
~/.hugagent/venv/bin/hugagent

またはDocker Composeを使用:

git clone https://github.com/ZJU-REAL/HugAgentOS.git
cd HugAgentOS
cp .env.example .env
mkdir -p data/storage
docker compose up -d --build

ドキュメントとコミュニティ – 英語と中国語のガイドが、導入、クイックスタート、デプロイメント、アーキテクチャ、オントロジー構築、モジュール開発をカバーしています。Issues、Discussions、またはプルリクエストを通じた貢献を歓迎します（ドキュメントと例のみ。コアコードはアップストリームリポジトリから生成されます）。

---

すべての詳細はリポジトリのREADMEから直接引用しており、外部の仮定は追加されていません。