Files
random-proxy-simple/readme.md
T
2026-04-27 12:27:27 +08:00

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`.