AgentRe Server

SaaS backend for the AgentRe project — accounts, devices, and RFC 8628 Device Flow.

Quick start (Docker)

mkdir -p runtime/keys
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out runtime/keys/jwt.key
openssl rsa -in runtime/keys/jwt.key -pubout -out runtime/keys/jwt.pub

cp .env.example .env                                 # 填 GitHub OAuth App 凭据
echo "SESSION_SECRET=$(openssl rand -base64 32)" >> .env

docker compose -f deploy/docker-compose.yml up -d
curl http://localhost:8443/v1/healthz

改配置、部署到 Kubernetes、自动发布，见 deploy/README.md。

Local dev

cp configs/config.example.yaml configs/config.yaml   # gitignored runtime 配置
# 把 db.dsn / redis.addr 指向你自己的 MySQL + Redis
make dev

make dev 同时跑 server（:8443）+ vite（:5174 proxy /v1）。服务也支持 --config <path>；显式路径失败时不回退，未传参数仍使用 configs/config.yaml。

真实 MySQL/Redis 浏览器冒烟的唯一自动入口是 make e2e；本地人工验证使用 pnpm serve + pnpm drive 或 gitignored scratch。详见 e2e/README.md。

GitHub OAuth App

1. GitHub Settings → Developer settings → OAuth Apps → New OAuth App
2. Homepage URL：https://<your-server>
3. Callback URL：https://<your-server>/v1/auth/oauth/github/callback
4. 复制 Client ID / Secret 到 .env

Architecture

改代码前先读 AGENTS.md 和 docs/。

基础设计 spec：../agentre-hub/docs/superpowers/specs/2026-06-16-hub-foundation-design.md