Files
random-proxy-simple/readme.md
T
2026-05-07 18:57:11 +08:00

86 lines
2.4 KiB
Markdown

# Agent Runbook
This app is already prepared for one-shot deployment. Follow these commands exactly unless one fails.
Do not add this repo to a parent workspace. Do not move it into `artifacts/`. Do not edit source files. Do not edit `package.json`. Do not create `config.json` or a `/tmp` config file for deployment. Do not inspect or free unrelated ports.
## Replit
The repo includes `.replit`, so after import the Run button starts the app with:
```bash
pnpm dev
```
The `.replit` `onBoot` command installs dependencies with:
```bash
pnpm install --ignore-workspace
```
For publishing from a workspace that clones this repo into `./random-proxy-simple`, configure the
workspace root `.replit` `[deployment]` block to build and run `random-proxy-simple` directly, then
create a shell web artifact so the publish UI has a web target.
## Install
Run from this repository root:
```bash
pnpm install --ignore-workspace
```
Use the available `pnpm`. This repo intentionally has no `packageManager` pin.
## Start
```bash
pnpm dev
```
When Replit AI Integrations are provisioned, the app reads these variables automatically:
- `AI_INTEGRATIONS_OPENAI_BASE_URL`
- `AI_INTEGRATIONS_OPENAI_API_KEY`
- `AI_INTEGRATIONS_ANTHROPIC_BASE_URL`
- `AI_INTEGRATIONS_ANTHROPIC_API_KEY`
Provider CLI flags are still supported for manual overrides:
```bash
pnpm dev -- \
--openai-base-url "<ai-integrations-openai-base-url>" \
--openai-api-key "<ai-integrations-openai-api-key>" \
--anthropic-base-url "<ai-integrations-anthropic-base-url>" \
--anthropic-api-key "<ai-integrations-anthropic-api-key>"
```
Use Replit AI Integrations endpoints only. Never use public official provider endpoints. Do not print provider tokens.
## Defaults
- host: `0.0.0.0`
- port: `3000`
- bearer token: `dev-proxy-key`
These can be overridden with CLI flags or environment variables:
- `--host` or `HOST`
- `--port` or `PORT`
- `--proxy-api-key` or `PROXY_API_KEY`
For mass deployments, pass the generated proxy token through `PROXY_API_KEY`. Replit AI
Integration provider values are read from the `AI_INTEGRATIONS_*` environment variables.
## Verify
```bash
curl -s http://localhost:3000/api/healthz
curl -s http://localhost:3000/dashboard | head
curl -s -H "Authorization: Bearer ${PROXY_API_KEY:-dev-proxy-key}" http://localhost:3000/v1/models
```
Expected without provider flags: dashboard, health, and model list work; chat completions return `503`.
Report only the local URL and verification results.