The Alquimia stack is a set of services that work together. When you runDocumentation Index
Fetch the complete documentation index at: https://docs.alquimia.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
| Service | Default URL | Description |
|---|---|---|
| Runtime | http://localhost:8080 | Event-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. |
| Twyd | http://localhost:8000 | Knowledge base service. Manages topics, file ingestion, and vector search for RAG. |
| Studio | http://localhost:3001 | This app — the visual agent builder. Login via Keycloak or Lite. Observability: agent metrics dashboards here, on OpenTelemetry standards, backed by Prometheus metrics. |
| Insight Hub | http://localhost:3000 | Knowledge exploration — Topics, documents, and streaming AI chat (separate from agent observability). |
| MinIO | http://localhost:19001 | S3-compatible object storage for files and documents. Console at port 19001. |
| Qdrant | http://localhost:6333 | Vector database for Knowledge Base semantic search and related runtime retrieval (e.g. summarized context when using strategies that persist to collections). |
| Postgres | internal | Relational database used by Twyd and Insight Hub. |
| Redis | internal | Cache and message queue used by the Runtime. |
| MongoDB | localhost:27017 | Studio’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.
| Variable | Default | Service |
|---|---|---|
RUNTIME_HOST_PORT | 8080 | Runtime |
STUDIO_HOST_PORT | 3001 | Studio |
INSIGHT_HUB_HOST_PORT | 3000 | Insight Hub |
OLLAMA_HOST_PORT | 11434 | Ollama (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
Next steps
Installation
Get the full stack running with a single command.