Takuto Core のインストール

これは自分で container を構築する方法です: Takuto Core エンジンを clone し、config.toml を 編集して、Docker Compose で直接動かします。イメージ、デプロイ、そして前段のネットワークを 完全にコントロールしたいときに選んでください。

1 つのプロジェクトで手早く試したいだけですか? Takuto CLI が これらのファイルを生成し、Compose を実行してくれます。どちらの方法も同じエンジンを動かします。

前提条件

概要 → 前提条件 を参照してください。要点: docker compose 付きの Docker（または Podman）、8 GiB 以上の RAM、30 GiB 以上の空きディスク、GitHub トークン、 そして AI プロバイダーのアカウント。

個人開発者（ローカル）

Takuto Core をノート PC で動かします。この方法では container イメージをローカルでビルドするため、15〜20 分ほどを見込んでください。

1. clone して設定

git clone https://github.com/takuto-team/takuto-core && cd maestro-core
cp config.toml.example config.toml
cp takuto.env.example takuto.env

config.toml を編集します:

  • [general] ticketing_system を "jira"、"github"、または "none" に設定。
  • Jira の場合: [jira] site、project_keys、email を記入。
  • GitHub Issues の場合: リポジトリは clone したリポジトリの git remote から検出されます。

シークレット は takuto.env に置きます（config.toml には決して書かないこと）:

export ANTHROPIC_API_KEY="sk-ant-..."
export GH_TOKEN="github_pat_..."

2. ビルド

docker compose build

3. 認証（初回のみ）

docker compose run --rm -it takuto setup

これは GitHub CLI → Atlassian CLI（任意）→ Claude Code または Cursor Agent → リポジトリの clone の順に案内します。

macOS の Podman: 先に VM のリソースを増やしてください:

podman machine stop && podman machine set --memory 12288 --cpus 4 && podman machine start

4. 起動

docker compose up

ダッシュボードは http://localhost:8080 にあります。初回起動時、最初の admin アカウントを 作成してください。Jira または GitHub Issues を使う場合はポーリングが自動で始まります。 そうでなければ + をクリックして workflow を手動で開始します。

チーム展開（サーバー）

Takuto Core を Linux サーバーにセルフホストします。チームはブラウザ越しにダッシュボードを 使い、エージェントはバックグラウンドで動きます。

1. サーバー上で clone して設定

git clone https://github.com/takuto-team/takuto-core && cd maestro-core
cp config.toml.example config.toml
cp takuto.env.example takuto.env

共有デプロイの主な設定:

[general]
ticketing_system = "jira"          # または "github"
max_concurrent_workflows = 3       # サーバーの CPU/RAM に合わせて調整

[web]
host = "0.0.0.0"
port = 8080

Takuto Core は認証にマルチユーザーのデータベースを使います。初回起動時、ダッシュボードは 最初の admin アカウントの作成を促します。その admin が以降、設定 → Users から ユーザーを追加できます。

2. ビルドして認証

docker compose build
docker compose run --rm -it takuto setup

3. サービスとして起動

docker compose up -d

4. 前段にリバースプロキシを置く（推奨）

Takuto Core は素の HTTP でリッスンします。ポート 8080 に向けた nginx または Caddy で 前段の TLS を終端してください。

Caddy のスニペット例:

takuto.yourcompany.com {
    reverse_proxy localhost:8080
}

TLS ターミネーターの背後にあるときは、cookie と CORS が正しく動くよう、ダッシュボードの 許可オリジンを設定します:

[web]
cors_origins = ["https://takuto.yourcompany.com"]

cookie_secure は cors_origins や受信した X-Forwarded-Proto: https ヘッダーから HTTPS を 自動検出します。プロキシがそのヘッダーを送らない場合は true を強制してください。 完全な [web] テーブルは 設定リファレンス を参照してください。

マルチユーザーモデル

Takuto Core は マルチユーザー、シングルテナント です: 各ユーザーは自分のダッシュボード ビューを持ちますが、1 つのインスタンス上のすべてのユーザーは同じ Jira、GitHub、AI の 認証情報を共有します。

  • admin — ユーザーの作成・編集・停止・削除と、共有設定（ポーリング、同時実行数、 ワークスペース切り替え、リポジトリの clone）の変更ができます。
  • user — 自分が作成した workflow のみを閲覧・操作できます。admin であってもユーザーを またいだ可視性はありません。

サインインはユーザー名 + パスワード（argon2 でハッシュ化）です。セッションはアイドル TTL が 24 時間、絶対 TTL が 30 日で、10 分以内に 5 回認証に失敗するとアカウントがロックされます。 アカウント作成時に発行される 1 回限りのリカバリーコードで、忘れたパスワードをリセットできます。

アカウントを与えた相手は誰でも、デプロイの ID で — takuto.env 内のトークンも含めて — ワーカー container 内でコードを実行できます。 信頼できない相手にアカウントを与えないでください。

再起動をまたいだ永続性

すべての認証状態（GitHub、Atlassian、Claude/Cursor）、workflow のスナップショット、npm キャッシュは名前付きの Docker ボリュームに置かれます。workflow は docker compose restart を 生き延びます — 一時停止中や進行中の実行は自動的に再開されます。

オプションのサイドカー

  • Docker-in-Docker — docker-compose.dind.yml をマージして、各 workflow のステップを 使い捨ての Docker container で実行します（同時実行の workflow どうしのポートやファイルシステムの 衝突を防ぎます）。Takuto Core の拡張 を参照してください。
  • セルフホストモデルブリッジ — OpenCode プロバイダーをホスト Mac 上で動くモデルサーバーに 向けるとき、docker-compose.lm-bridge.yml をマージします。セルフホストモデル を参照してください。

次のステップ