Skip to main content
The Alquimia stack is a set of services that work together. When you run docker compose up, all of these start automatically. You only need to interact with Studio and occasionally the others when debugging.

Services at a glance

ServiceDefault URLDescription
Runtimehttp://localhost:8080Event-driven agent execution platform. Orchestrates multi-agent LLM runs in containerized environments, including context-aware prompting, memory strategies, RAG-aware retrieval flows, and complex tool execution. Designed for Kubernetes and OpenShift. Visit /docs for the Swagger API.
Twydhttp://localhost:8000Knowledge base service. Manages topics, file ingestion, and vector search for RAG.
Studiohttp://localhost:3001This app — the visual agent builder. Login via Keycloak or Lite. Observability: agent metrics dashboards here, on OpenTelemetry standards, backed by Prometheus metrics.
Insight Hubhttp://localhost:3000Knowledge exploration — Topics, documents, and streaming AI chat (separate from agent observability).
MinIOhttp://localhost:19001S3-compatible object storage for files and documents. Console at port 19001.
Qdranthttp://localhost:6333Vector database for Knowledge Base semantic search and related runtime retrieval (e.g. summarized context when using strategies that persist to collections).
PostgresinternalRelational database used by Twyd and Insight Hub.
RedisinternalCache and message queue used by the Runtime.
MongoDBlocalhost:27017Studio’s database. Stores models, MCP servers, embeddings configurations, and settings.
You don’t need to interact with most of these services directly. Studio orchestrates everything through the Registry API. Use Studio for building agents and for metrics dashboards; open Insight Hub (3000) when you want topic-based knowledge exploration and chat.

Port configuration

All ports are configurable via environment variables in your .env file before running docker compose up.
VariableDefaultService
RUNTIME_HOST_PORT8080Runtime
STUDIO_HOST_PORT3001Studio
INSIGHT_HUB_HOST_PORT3000Insight Hub
OLLAMA_HOST_PORT11434Ollama (local models profile)

Data storage

The stack persists data in Docker volumes:
  • MongoDB — Studio’s settings (models, MCP, embeddings)
  • Postgres — Twyd and Insight Hub application data (topics, documents, tenants, chat-related persistence)
  • Qdrant — Vector storage/search for knowledge base and workloads that use embeddings-backed retrieval
  • MinIO — Uploaded documents and files
Running docker compose down -v removes all volumes and deletes all persisted data, including your agents, settings, and knowledge base. Use docker compose down (without -v) to stop services while keeping data.

Next steps

Installation

Get the full stack running with a single command.