Settings

Service endpoint configuration for the Alchimista dashboard. These values are read from environment variables at startup. Update them in your deployment environment.

Active Configuration

Current service endpoint values

Environment Variable	Current Value	Description
`INGEST_URL`	—	ingestion-api-service base URL
`PROCESSOR_URL`	—	document-processor-service base URL
`RAG_URL`	—	rag-query-service base URL
`ADMIN_KEY`	—	Admin key for governance endpoints (`x-admin-key`)

Local Development

Run the dashboard against local service instances

# .env
INGEST_URL=http://localhost:8011
PROCESSOR_URL=http://localhost:8012
RAG_URL=http://localhost:8013
ADMIN_KEY=your-local-admin-key

# Start dashboard
INGEST_URL=http://localhost:8011 \
PROCESSOR_URL=http://localhost:8012 \
RAG_URL=http://localhost:8013 \
ADMIN_KEY=dev-key \
python -m dux.dashboard

Cloud Run Deployment

Point to production Cloud Run service URLs

# gcloud deploy with env vars
gcloud run deploy alchimista-dashboard \
  --image gcr.io/PROJECT/dashboard:latest \
  --set-env-vars \
    INGEST_URL=https://ingest-xyz-ew.a.run.app,\
    PROCESSOR_URL=https://processor-xyz-ew.a.run.app,\
    RAG_URL=https://rag-xyz-ew.a.run.app,\
    ADMIN_KEY=prod-secret-key

Service Reference

Alchimista Cloud Run services and their responsibilities

Service	Default Port	Responsibility	Key Endpoints
ingestion-api-service	`8011`	Accepts ingest requests, creates jobs, publishes to Pub/Sub	`POST /v1/ingest, GET /v1/doc/{id}`
document-processor-service	`8012`	Consumes Pub/Sub jobs, chunks documents, generates embeddings	`POST /v1/process, POST /v1/process/pubsub`
rag-query-service	`8013`	RAG queries, AI decision trail, governance admin	`POST /v1/query, POST /v1/decisions, /v1/admin/*`
dashboard	`8000`	This management UI — proxies requests to the three services above	`GET /api/v1/health, /api/settings`