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

2.6 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

For publishing from a workspace that clones this repo into ./random-proxy-simple, create a kind = "web" artifact and point its production build/run commands at this proxy. Do not publish this proxy as a kind = "api" artifact and do not rely on root .replit deployment settings. Use pnpm build:fast for Replit publish builds.

Install

Run from this repository root:

pnpm install --ignore-workspace

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

Start

node build.mjs && PORT=${PORT:-3001} PROXY_API_KEY=${PROXY_API_KEY:-dev-proxy-key} node --enable-source-maps dist/index.mjs

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: 3001
  • 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

curl -s http://localhost:3001/api/healthz
curl -s http://localhost:3001/dashboard | head
curl -s -H "Authorization: Bearer ${PROXY_API_KEY:-dev-proxy-key}" http://localhost:3001/v1/models

Expected without provider flags: dashboard, health, and model list work; chat completions return 503.

Report only the local URL and verification results.