Files
random-proxy-simple/readme.md
T
2026-05-06 20:55:34 +08:00

2.2 KiB

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:

pnpm dev

The .replit onBoot command installs dependencies with:

pnpm install --ignore-workspace

Install

Run from this repository root:

pnpm install --ignore-workspace

Use the available pnpm. This repo intentionally has no packageManager pin.

Start

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:

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, set PROXY_API_KEY to the token generated by the deployment system. The app will use that token as the required Authorization: Bearer ... value.

Verify

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.