Reference implementation of the agenthub-spec registry APIs.

Start PostgreSQL and Redis locally:

docker compose up -d

Persistent local data is stored in:

.docker/postgres
.docker/redis

The default local environment matches .env.example:

PORT=3000
LOG_LEVEL=debug
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/agenthub
REDIS_URL=redis://localhost:6379
DEV_PUBLISHER_SUBJECT=publisher:local-dev
CORS_ORIGIN=*

Generate Drizzle migrations after schema changes:

bun run db:generate

For a fresh local database, apply the generated migrations:

bun run db:migrate

To inspect the local database in Drizzle Studio:

bun run db:studio

Start the app:

bun run dev

For a step-by-step local QA guide covering Postman requests, happy paths, and known placeholder routes, see docs/manual-testing.md.

For the publish-to-active domain verification flow and its ownership model, see docs/domain-verification-workflow.md.

Build the production image:

docker build -t agenthub .

Run it against the local Postgres and Redis services:

docker run --rm \
  -p 3000:3000 \
  -e DATABASE_URL=postgresql://postgres:postgres@host.docker.internal:5432/agenthub \
  -e REDIS_URL=redis://host.docker.internal:6379 \
  agenthub

Run the test suite with:

bun test