Ecosystem Services Reference

Services

Service	Default Port	URL	Description
Runtime	8080	http://localhost:8080	Event-driven agent execution platform. Orchestrates multi-agent LLM runs (prompting, memory, tool execution, and retrieval flows).
Twyd	8000	http://localhost:8000	Knowledge base service — topics, files, vector search.
Studio	3001	http://localhost:3001	Agent builder. Login via Keycloak or Lite. In-app metrics dashboards for agents (OpenTelemetry; Prometheus-backed).
Insight Hub	3000	http://localhost:3000	Knowledge exploration app — Topics, document ingestion, and streaming AI chat over the Alquimia runtime.
MongoDB	27017	—	Studio’s database (models, MCP, sentinels, settings).
Ollama	11434	http://localhost:11434	Local LLM inference (with-local-models profile only).

Environment variables

All configuration lives in .env in the alquimia-local directory.

Shared

Variable	Description
`API_TOKEN`	Internal API token shared between services
`AUTH_PROVIDER`	Authentication provider identifier
`ASSISTANT_BASEURL`	Registry API base URL (used by Studio)

Models (cloud & custom endpoints)

Cloud providers, API keys, and Base URL overrides (including OpenAI-compatible proxies and local inference URLs) are configured in Studio → Settings → Models Registry, not via provider blocks in .env.

Runtime

Variable	Description
`RUNTIME_HOST_PORT`	External port for the Runtime service (default: 8080)
`K_SINK`	Event sink URL for async messaging
`ALQUIMIA_REGISTRY_DIR`	Directory for local registry storage

Router

Variable	Description
`ROUTER_HOST_PORT`	External port for the Router service (default: 8081)
`ALQUIMIA_RUNTIME_URL`	URL the Router uses to reach the Runtime
`ROUTER_RUNTIME_TIMEOUT_SECONDS`	Request timeout in seconds

Studio

Variable	Description
`STUDIO_HOST_PORT`	External port for Studio (default: 3001)
`AUTH_KEYCLOAK_ID`	Keycloak client ID
`AUTH_KEYCLOAK_SECRET`	Keycloak client secret
`AUTH_KEYCLOAK_ISSUER`	Keycloak issuer URL
`STUDIO_NEXTAUTH_SECRET`	NextAuth.js session secret

Database

Variable	Description
`POSTGRES_USER`	Postgres username
`POSTGRES_PASSWORD`	Postgres password
`POSTGRES_DB`	Postgres database name
`MONGO_INITDB_ROOT_USERNAME`	MongoDB root username
`MONGO_INITDB_ROOT_PASSWORD`	MongoDB root password

MinIO

Variable	Description
`MINIO_ROOT_USER`	MinIO admin username
`MINIO_ROOT_PASSWORD`	MinIO admin password
`BLOB_S3_*`	S3-compatible storage configuration for Twyd

Ollama (local models profile)

Variable	Description
`OLLAMA_MODELS`	Space-separated model names to pull and register
`OLLAMA_HOST_PORT`	External port for Ollama (default: 11434)
`OLLAMA_BASE_URL`	Base URL used by the Runtime to call Ollama

Insight Hub

Insight Hub is the knowledge-exploration UI (topics, documents, streaming chat). It is not the observability surface for agents — that lives in Studio (see Studio row above).

Variable	Description
`INSIGHT_HUB_HOST_PORT`	External port for Insight Hub (default: 3000)
`INSIGHT_HUB_AUTH_PROVIDER`	Auth provider for Insight Hub

All port variables follow the pattern {SERVICE}_HOST_PORT. Override them in .env before running docker compose up — changing them after containers are created requires docker compose down first.

Welcome

Getting Started

Platform

Core Concepts

Ecosystem

Reference

Ecosystem Services Reference

Services

Environment variables

Shared

Models (cloud & custom endpoints)

Runtime

Router

Studio

Database

MinIO

Ollama (local models profile)

Insight Hub

​Services

​Environment variables

​Shared

​Models (cloud & custom endpoints)

​Runtime

​Router

​Studio

​Database

​MinIO

​Ollama (local models profile)

​Insight Hub

Services

Environment variables

Shared

Models (cloud & custom endpoints)

Runtime

Router

Studio

Database

MinIO

Ollama (local models profile)

Insight Hub