65 lines
1.5 KiB
Markdown
65 lines
1.5 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`.
|
|
|
|
The app runs without `config.json`:
|
|
|
|
- host: `0.0.0.0`
|
|
- port: `24731`
|
|
- bearer token: `dev-proxy-key`
|
|
|
|
## Optional Provider Config
|
|
|
|
Do not create `config.json` unless internal provider endpoints/tokens are available.
|
|
|
|
If they are available, create `config.json` in one write with this shape:
|
|
|
|
```json
|
|
{
|
|
"server": {
|
|
"host": "0.0.0.0",
|
|
"port": 24731
|
|
},
|
|
"proxy": {
|
|
"apiKey": "dev-proxy-key"
|
|
},
|
|
"providers": {
|
|
"openai": {
|
|
"apiKey": "",
|
|
"baseURL": ""
|
|
},
|
|
"anthropic": {
|
|
"apiKey": "",
|
|
"baseURL": ""
|
|
}
|
|
},
|
|
"logging": {
|
|
"level": "info",
|
|
"pretty": true
|
|
}
|
|
}
|
|
```
|
|
|
|
Fill only `providers.openai.apiKey`, `providers.openai.baseURL`, `providers.anthropic.apiKey`, and `providers.anthropic.baseURL`. Use internal endpoints only. Never use public official provider endpoints.
|
|
|
|
## 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 config: dashboard, health, and model list work; chat completions return `503`.
|