Alquimia Runtime Helm Chart
This Helm chart deploys Alquimia Runtime, an event-driven and serverless engine for managing AI agents in enterprise environments. Built on Knative and Kubernetes, it ensures scalable and efficient deployment.
Prerequisites
A running Openshift or Kubernetes cluster.
Openshift Serverless (Knative) runtime installed.
Openshift Service Mesh (Istio) for networking.
AMQ Streams (Strimzi) for event-driven messaging.
A Redis instance for memory and cache management
A Couchdb instance to manage agent configurations
Optional: Vector store (e.g., Qdrant, Chroma, or ElasticSearch) for RAG capabilities.
π¦Helm chart repository
The Helm chart is currently available on Artifact Hub and will soon be available in the Red Hat catalog.
π Installation
To install the chart with the default values:
helm install my-release . --namespace alquimia-runtime
To override values:
helm install my-release . --namespace alquimia-runtime -f values.override.yaml
Or using --set:
helm install my-release . \
--set services.hermes.image="alquimiaai/hermes:latest" \
--set services.leviathan.image="alquimiaai/leviathan:latest"
βοΈ Configurable Parameters
The following table lists the configurable parameters of this chart and their default values.
1οΈβ£ Eventing Configuration (eventing
)
eventing
)eventing.brokers
List of Knative Broker
resources
See values.yaml
eventing.configBroker.name
Name of the ConfigMap for Kafka Broker
kafka-broker-config
eventing.configBroker.namespace
Namespace where the ConfigMap is located
knative-eventing
eventing.triggers
List of Knative Trigger
resources
See values.yaml
eventing.sequences
List of Knative Sequence
resources
See values.yaml
eventing.sinkBindings
List of Knative SinkBinding
resources
See values.yaml
πΉ Example - Custom Broker Configuration
eventing:
brokers:
- name: inbound
serviceRef: alquimia-hermes
- name: normalized
serviceRef: alquimia-hermes
2οΈβ£ Service Configuration (services
)
services
)services.hermes.name
Name of the hermes service
"alquimia-hermes"
services.hermes.image
Image for hermes service
""
services.leviathan.name
Name of the leviathan service
"alquimia-leviathan"
services.leviathan.image
Image for leviathan service
""
πΉExample - Setting Custom Images
services:
hermes:
image: "alquimiaai/hermes:latest"
leviathan:
image: "alquimiaai/leviathan:latest"
3οΈβ£ Configuration Variables (configuration
)
configuration
)configuration.name
Name of the ConfigMap
"alquimia-env"
configuration.namespace
Namespace for the ConfigMap
"alquimia-runtime"
πΉEnvironment Variables
General Configuration
DEBUG
Enable or disable debug mode (true
/false
)
API_URL
Base URL of the API
API_TOKEN
Token for API authentication
DEFAULT_COLLECTION_ID
Default collection identifier
Caching & Storage
ALQUIMIA_CACHE
Cache configuration for Alquimia
TRANSFORMERS_CACHE
Path for transformers cache
HF_HOME
Path for Hugging Face models
SENTENCE_TRANSFORMERS_HOME
Path for Sentence Transformers cache
Object Storage (S3)
ALQUIMIA_S3_ACCESS_KEY_ID
S3 access key ID
ALQUIMIA_S3_SECRET_KEY
S3 secret access key
ALQUIMIA_S3_BUCKET
S3 bucket name
ALQUIMIA_S3_ENDPOINT_URL
S3 endpoint URL
Database & Message Brokers
REDIS_URL
Redis connection URL
COUCHDB_URL
CouchDB connection URL
QDRANT_URL
Qdrant vector database URL
QDRANT_API_KEY
API key for Qdrant authentication
Observability & Monitoring
APM_SERVER_URL
APM server URL
APM_SECRET_TOKEN
Secret token for APM authentication
Email Configuration
SMTP_SERVER
SMTP server for sending emails
IMAP_SERVER
IMAP server for receiving emails
GMAIL_USERNAME
Gmail username
GMAIL_PASSWORD
Gmail password
Integrations
SLACK_BOT_TOKEN
Slack bot authentication token
πΉExample - Custom Environment Variables
configuration:
env:
API_URL: "https://api.alquimia.ai"
DEBUG: "true"
π οΈ Usage Examples
π Deploy with Custom Images and Configurations
helm install my-alquimia-app . \
--set services.hermes.image="alquimiaai/hermes:latest" \
--set services.leviathan.image="alquimiaai/leviathan:latest" \
--set configuration.env.DEBUG="true"
π Upgrade an Existing Deployment
helm upgrade my-alquimia-app . -f values.override.yaml
ποΈ Uninstall
helm uninstall my-alquimia-app
Last updated