Space

Space

Space は、AI エージェントと共有するワークスペースです。ドキュメント、タスク、データベース、長期記憶をエージェントが MCP 経由で読み書きでき、同じ内容を確認、修正、編集できるウェブサイトも備えています。Claude Code、Codex、Cursor、その他の MCP クライアントを接続すれば、あるセッションで学習した内容が次のセッションにも引き継がれます。

このリポジトリは、オープンソースでセルフホスト可能なエディションです。Docker Compose を使い、管理下にある小規模な VPS などのマシン 1 台で実行できます。クラウドアカウントは不要です。ホステッドデータベース、オブジェクトストレージ、キー管理サービス、サインインプロバイダーも必要ありません。

利用できる機能

• ドキュメントとタスク：完全な変更履歴を備え、ウェブサイトまたはエージェントから編集できます。
• データベース：型付きのテーブルとボードを備え、エージェントは SQL でクエリや変更を行えます。
• エージェントの記憶：セッション間の引き継ぎに加え、エージェントが記憶し、引用付きで想起し、修正し、忘れる情報を扱えます。
• Space 全体の検索と想起：単語で検索でき、モデルプロバイダーを設定すると意味による検索もできます。
• すべてのエージェントで使える 1 つの MCP エンドポイント：エージェントごとに失効可能なトークンまたはブラウザーサインインを設定でき、誰が何を書いたかを追跡できます。
• REST API：個人用 API キーと、データベースの行が変更されたときに送信される署名付き Webhook を利用できます。
• プロジェクト、フォルダー、セクション、カテゴリ：エージェントが新しい作業を分類するときに従う項目です。

構成

部分	実行するもの
caddy	公開される唯一のサービスです。HTTPS を提供し、自動で証明書を取得してリクエストをルーティングします。
web	ウェブサイト（Node.js 上の TanStack Start）です。
api	REST API と MCP エンドポイント（Python、FastAPI）です。
worker	バックグラウンドでの記憶の抽出です。
webhooks	署名付き Webhook の配信です。
db	pgvector を備えた PostgreSQL 17 です。すべてのドキュメント、タスク、記憶、設定がここに保存されます。

コンテンツは PostgreSQL に読み取り可能な JSON として保存されます。アプリケーションレベルの暗号化はありません。一般的なセルフホスト型アプリケーションと同様に、サーバーの運用者はデータを読み取れます。データベースをバックアップし、サーバーを適切に保護してください。

インストール

1 GB 以上のメモリを備えた Linux サーバー（小規模な VPS など）が必要です。また、一般公開する場合は、そのサーバーを指す DNS レコードが設定されたドメイン名が必要です。サーバー上で次を実行します。

curl -fsSL https://raw.githubusercontent.com/Hugo-SEQUIER/getspace/main/scripts/install.sh | sudo bash

インストーラーは、Docker がない場合はインストールし、最新リリースを /opt/space にダウンロードして、アクセスモード、ドメイン、名前を尋ねます。その後、Space を起動し、アドレスとアクセスキーを表示します。同じ手順を手動で行うには、次を実行します。

git clone https://github.com/Hugo-SEQUIER/getspace.git
cd getspace
git checkout "$(git tag -l 'v*' | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -n 1)"   # latest release
scripts/setup.sh                 # asks for the access mode and your domain, writes .env
docker compose up -d             # downloads the released images and starts everything
docker compose exec api python -m space.check   # checks every setting, in plain words

どちらの方法でも、次の 2 つのアクセスモードを選べます。

• キー モード（デフォルト）：Space は https://your-domain でインターネットからアクセスできます。ウェブサイトでは、ブラウザーごとにインスタンスのアクセスキーを一度入力します。各エージェントは、それぞれ失効可能なトークンで接続します。DNS レコードをサーバーに向け、ポート 80 と 443 を開くと、Caddy が証明書を取得します。
• プライベートモード：アクセスチェックは一切ありません。Space は 127.0.0.1:8080 で待ち受け、SSH トンネルまたは Tailscale などの VPN 経由でアクセスします。このモードを一般公開してはいけません。

ユーザーアカウントはありません。1 つのインストールにつき、所有者 1 人が利用します。セルフホスティングでは、両方のモード、すべての設定、アップグレード、バックアップ、トラブルシューティングについて説明しています。

ホステッド版 Space から移行しますか？そちらで Space をエクスポートし、こちらにインポートしてください：ホステッド版 Space からの移行。

エージェントを接続する

ウェブサイトで Agents → Connect an agent を開き、名前と書き込み権限の有無を選んで、表示された設定をコピーします。Claude Code の場合：

claude mcp add --transport http space https://your-domain/mcp/ \
  --header "Authorization: Bearer spc_..."

claude.ai や ChatGPT などのホステッドアシスタントは、代わりにサインインします。https://your-domain/mcp/ をカスタムコネクターとしてアプリに追加し、ブラウザーで Space が開いたら接続を承認します。

プライベートモードでは、エージェントにトークンは不要です：claude mcp add --transport http space http://127.0.0.1:8080/mcp/。エージェントの接続では、Codex、Cursor、その他のクライアント向けの設定を紹介しています。また、オプションのエージェントスキルでは、想起、記憶、引き継ぎを行うタイミングをエージェントに教えます。

モデルプロバイダーを使用したメモリ

ドキュメント、タスク、データベース、引き継ぎ、単語検索は、モデルがなくても利用できます。自動メモリ（テキストからの主張の抽出、埋め込み、セマンティック検索）には、OpenAI 互換のエンドポイントまたは Ollama が必要です。.env で SPACE_MEMORY_PROVIDER と関連する設定を指定してください。エージェントが Space に処理を依頼したテキストのみが、そのプロバイダーに送信されます。OpenRouter の Decisions API の判断モデルを使って、検索結果の根拠を評価し、カテゴリやプロジェクトに基づいてメモリを整理し、関連するメモリをリンクすることもできます。これらの機能は、それぞれ有効にするまでオフになっています。メモリを参照してください。

バックアップとアップグレード

scripts/backup.sh                                  # writes backups/space-<time>.dump
scripts/upgrade.sh                                 # backs up, then moves to the latest release
scripts/restore.sh backups/space-<time>.dump       # replace this installation's data

バックアップはサーバーの外部にコピーしてください。同じディスク上のバックアップは、バックアップではありません。

ドキュメント

ドキュメント	内容
セルフホスティング	インストール、アクセスモード、設定、アップグレード、バックアップ、セキュリティ、トラブルシューティング。
ホスト型 Space からの移行	ホスト型 Space をエクスポートし、自分のインストール環境にインポートする方法。
エージェントの接続	トークン、クライアントの設定、エージェントの ID、デバイスコードフロー。
アーキテクチャ	プロセス、ストレージ、アクセス制御、バックグラウンド処理。
開発	ソースからの実行、テスト、チェック。
MCP	エージェントのインターフェースとそのツール。
メモリ	引き継ぎ、主張、検索、主張インデックス。
Webhook	データベースの行が変更されたときの署名付き通知。
用語集	システムで使用されるすべての用語。
API リファレンス	個人用 API キーで呼び出せる REST API（OpenAPI）。

ライセンス

Space は、GNU Affero General Public License v3.0 に基づくフリーソフトウェアです。あらゆる目的で使用、変更、セルフホストできます。変更を加えたバージョンをネットワーク経由で他の人に提供する場合は、そのソースコードを提供する必要があります。同梱されている Memora ランタイムには、引き続き MIT ライセンスが適用されます。NOTICE と THIRD-PARTY.md を参照してください。

コントリビューションを歓迎します。最初のプルリクエストを送る前に、CONTRIBUTING.md を読み、コントリビューターライセンス契約に同意してください。