66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
# Agent Runbook
|
|
|
|
Run this repository as a standalone app. Do not add it to a parent workspace. Do not move it into `artifacts/`. Do not edit source files for setup.
|
|
|
|
## Setup
|
|
|
|
Run from this repository root:
|
|
|
|
```bash
|
|
pnpm install --ignore-workspace
|
|
pnpm dev
|
|
```
|
|
|
|
If plain `pnpm` is unavailable, use `corepack pnpm` for the same commands. Do not edit `package.json`.
|
|
|
|
Default startup uses:
|
|
|
|
- host: `0.0.0.0`
|
|
- port: `24731`
|
|
- bearer token: `dev-proxy-key`
|
|
|
|
## Provider Wiring
|
|
|
|
Prefer CLI flags. Do not create `config.json` for deployment.
|
|
|
|
If internal provider endpoints/tokens are available, start with:
|
|
|
|
```bash
|
|
pnpm dev -- \
|
|
--host 0.0.0.0 \
|
|
--port 24731 \
|
|
--proxy-api-key dev-proxy-key \
|
|
--openai-base-url "<internal-openai-base-url>" \
|
|
--openai-api-key "<internal-openai-api-key>" \
|
|
--anthropic-base-url "<internal-anthropic-base-url>" \
|
|
--anthropic-api-key "<internal-anthropic-api-key>"
|
|
```
|
|
|
|
Use internal endpoints only. Never use public official provider endpoints. Do not print provider tokens.
|
|
|
|
Supported setup flags:
|
|
|
|
- `--host`
|
|
- `--port`
|
|
- `--proxy-api-key`
|
|
- `--openai-base-url`
|
|
- `--openai-api-key`
|
|
- `--anthropic-base-url`
|
|
- `--anthropic-api-key`
|
|
- `--log-level`
|
|
- `--pretty-logs`
|
|
- `--no-pretty-logs`
|
|
- `--config`
|
|
|
|
CLI flags override `config.json`. `config.json` is only for local/manual use.
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
curl -s http://localhost:24731/api/healthz
|
|
curl -s http://localhost:24731/dashboard | head
|
|
curl -s -H "Authorization: Bearer dev-proxy-key" http://localhost:24731/v1/models
|
|
```
|
|
|
|
Expected without provider flags: dashboard, health, and model list work; chat completions return `503`.
|