Settings
This page documents the environment variables used to configure Easy8 AI Chain.
All variables are optional unless stated otherwise. Use the deployment .env template provided with the Easy8 package as your starting point.
Embeddings
Fill the following variables if you are using custom TEI (Text Embeddings Inference) server.
| Variable |
Default |
Description |
EMBEDDINGS_URL |
(none) |
Base URL of the TEI (Text Embeddings Inference) server used for vector generation. |
TEI_API_KEY |
(none) |
Optional API key for the TEI server. When set, it is sent as a Bearer token in the Authorization header of every request to the TEI server. |
Supported embeddings models
For on-premises self-hosted deployments, the supported embeddings model is BAAI/bge-m3 served through a TEI endpoint.
On-premises TEI deployment for BAAI/bge-m3 is supported only on NVIDIA GPU infrastructure with minimum 8 GB VRAM. CPU-only deployment is not supported.
| Model name |
Provider |
Notes |
BAAI/bge-m3 |
TEI server |
Supported model for on-premises self-hosted retrieval deployments; requires NVIDIA GPU with minimum 8 GB VRAM. |
LLM Providers
These variables apply to cloud-provider scenarios. Self-hosted on-premises LLM deployments use LLM_URL in the scenario guides.
| Variable |
Default |
Description |
OPENAI_API_KEY |
(none) |
Enables OpenAI LLMs and embeddings models. |
AZURE_OPENAI_API_KEY |
(none) |
Enables Azure OpenAI LLMs and embeddings. Requires AZURE_OPENAI_ENDPOINT. |
AZURE_OPENAI_ENDPOINT |
(none) |
Azure OpenAI service endpoint URL. |
OPENAI_EMBEDDINGS_API_KEY |
(none) |
Separate OpenAI API key used only for embeddings, for deployments that use non-OpenAI LLMs but OpenAI embeddings. |
MISTRAL_API_KEY |
(none) |
Enables MistralAI hosted models. |
DEFAULT_LLM_ID |
(none) |
Override the default LLM model ID. |
Infrastructure
| Variable |
Default |
Description |
CHROMADB_URL |
http://chroma:8000 |
URL of the ChromaDB vector database. |
CELERY_BROKER_URL |
redis://redis:6379/0 |
Redis URL used as Celery message broker. |
CELERY_RESULT_BACKEND |
redis://redis:6379/0 |
Redis URL used for Celery task results. |
CHAIN_DATA_PATH |
/data |
Directory for persistent data (configurations, temporary files). |
Security
| Variable |
Default |
Description |
EASY_JWT_SECRET |
(none) |
JWT secret for authenticating HTTP endpoints. When unset, JWT authentication is disabled. |
EASY_AI_CORS_ALLOWED_ORIGINS |
(none) |
Comma-separated list of allowed CORS origins. In debug mode, all origins are allowed. |
CORS_DISABLED |
false |
Set to true to disable CORS middleware entirely. |
Observability
| Variable |
Default |
Description |
LANGCHAIN_TRACING_V2 |
true (when API key is set) |
Enable or disable LangSmith tracing. |
LANGCHAIN_API_KEY |
(none) |
LangSmith API key. Setting this enables tracing. |
LANGCHAIN_PROJECT |
clients |
LangSmith project name for trace grouping. |
LANGCHAIN_ENDPOINT |
https://api.smith.langchain.com |
LangSmith API endpoint. |
Debug
| Variable |
Default |
Description |
CHAIN_DEBUG_MODE |
false |
Enable debug mode (true or 1). |