Quick Start

Docker Composeでローカル起動する。

Agents partyは compose.yaml でPostgreSQL、Redis、migration、web、workerをまとめて起動できます。 Slack接続なしでも、まずはhealth checkまで確認できます。

Required

必要なもの

Docker Compose。コンテナ外で開発する場合だけNode.js 22.xとVite+ CLIの vp も使います。

Slack

あとで接続

実Slackで試すときだけ .env と公開HTTPSトンネルを用意します。

More

詳細

設定値、Slack scopes、provider keyの扱いはREADMEを参照してください。

最短手順

起動する

webworker を指定すると、DB、Redis、migrationも一緒に動きます。

docker compose up --build web worker

確認する

別シェルでhealth checkを叩きます。

curl http://localhost:8000/healthz

必要なら初期routeを入れる

Slack app mentionを試す前に、workspace team idでbootstrap routeを作ります。

AGENTS_PARTY_BOOTSTRAP_TEAM_ID=T123456789 \
docker compose --profile seed run --rm seed

Slackにつなぐ

.env にSlack OAuth設定を入れ、manifestのURLを公開HTTPSトンネルに置き換えてimportします。

cp .env.example .env
docker compose up --build web worker

ログを見る

docker compose logs -f web
docker compose logs -f worker

停止する

docker compose down
docker compose down -v  # DB/Redisも消す場合

コンテナ外で動かす場合

詳細はREADMEのQuick Startを参照してください。通常のJS/TS操作はVite+ CLIの vp を使います。

PR前の検証

変更前後の確認にはこのセットを使います。

vp check
vp run typecheck
vp test
vp pack