概要
Odysseus は、ChatGPTやClaudeのような体験を自分のハードウェアで実現できる 自己ホスト型AIワークスペース。 プライバシー重視、ローカルファースト設計で、データも自分で管理可能。 多彩な AIモデル・ツール連携、ドキュメント編集、メール、カレンダーなど幅広い機能を搭載。 Dockerやネイティブ環境 で簡単に導入でき、セキュリティ面にも配慮。 初期設定や運用、貢献方法まで 詳細なガイド が用意されている。
Odysseus:自己ホスト型AIワークスペース概要
- ChatGPTやClaudeのUI体験 を自分のPCやサーバーで再現できる自己ホスト型AIワークスペース
- プライバシー重視 ・ローカルデータ管理・トロイの木馬なし
- チャット機能 :ローカルモデルやAPI(vLLM、llama.cpp、Ollama、OpenRouter、OpenAIなど)との連携が簡単
- エージェント機能 :ツールを渡して自動でタスク実行
- Cookbook :ハードウェアスキャン、自動モデル推薦、ワンクリックダウンロード
- Deep Research :複数ステップの情報収集・要約・レポート作成
- モデル比較 :複数モデルのブラインドテスト、比較
- ドキュメント編集 :Markdown/HTML/CSV対応、AIによる編集・提案
- メモリ・スキル :永続的な記憶とスキル習得、ユーザーに合わせて進化
- メール連携 :IMAP/SMTP、AIによる振り分け・要約・返信下書き
- ノート・タスク :リマインダー付きメモ、ToDoリスト、スケジューラ
- カレンダー :CalDAV同期、エージェント連携、色分け
- モバイル対応 :PWA、レスポンシブ、タッチ操作
- その他 :画像編集、テーマ編集、ファイルアップロード、Web検索、2FA対応
導入手順・初期設定
- Docker推奨 :
git clone後、docker compose up -d --buildで起動- ホストは 127.0.0.1:7000 でWeb UIにアクセス
- ポート変更やLAN公開は
.envで設定 - 初回起動時、管理者アカウントと一時パスワードが自動生成
- ネイティブLinux/macOS :Python 3.11+必須、venv作成、
pip install -r requirements.txt、python setup.py、uvicornで起動- Apple SiliconはMetal対応のため
./start-macos.shを利用
- Apple SiliconはMetal対応のため
- Windows :
launch-windows.ps1で一括起動、または手動セットアップ- ローカルモデル利用はOllamaが最も簡単
- Cookbook :tmux必須、バックグラウンドでモデルダウンロード・起動
- 初期設定 はWeb UIのSettingsで行い、.envはデプロイ用環境変数のみ編集
セキュリティ・運用上の注意
- 強力なローカルツール (シェル、ファイル、APIトークン、メール等)を持つため、管理者権限の扱いに注意
- AUTH_ENABLED=true で認証を有効化し、ネットワーク公開時は必須
- 公開時はHTTPS必須 :Caddyやnginx等でリバースプロキシ・TLS終端を推奨
- データ・設定ファイル (data/, .env, logs等)はGit管理外、公開前にgit statusで確認
- ユーザー権限管理 :非管理者はシェルやファイル操作不可、管理者ルートは限定
- APIキー/トークンの取り扱い :流出防止、不要なものは削除、個別発行推奨
主要設定項目(.env例)
- LLM_HOST :LLMサーバーアドレス
- OPENAI_API_KEY :OpenAIキー(必要時のみ)
- SEARXNG_INSTANCE :SearXNGのURL
- APP_BIND/APP_PORT :Web UIのバインドアドレス・ポート
- AUTH_ENABLED :認証有効化
- DATABASE_URL :データベース接続先
- CHROMADB_HOST/PORT :ChromaDB設定
- EMBEDDING_URL :埋め込みエンドポイント
アーキテクチャ・データ構造
- FastAPI ベース(app.py)
- コア機能 :認証、DB、ミドルウェア、エージェント、チャット、検索、ドキュメント管理等
- フロントエンド :index.html、app.js、style.css、js/
- データ保存先 :data/配下に全ユーザーデータ(app.db、memory.json、uploads/等)
貢献方法・開発
- バグ報告・機能追加・ドキュメント改善 歓迎
- CONTRIBUTING.md にセットアップ・テスト・PRガイドラインを記載
- ROADMAP.md で募集中タスクを公開
まとめ
- Odysseus は、 自己ホスト型AIワークスペース として多機能・高い拡張性を持ち、 プライバシー・セキュリティ重視 の運用が可能
- Dockerや各OS向けセットアップ が用意され、導入も容易
- 管理者権限・ネットワーク公開時のセキュリティ対策 が必須
- コミュニティ貢献 も積極的に受け入れ、今後の発展に期待