diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..97e8e95
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,40 @@
+# ==============================================================================
+# ChainLearn AI - Environment Configuration Template
+# ==============================================================================
+# Copy this file to `.env` in the repository root and fill in your values.
+
+# ------------------------------------------------------------------------------
+# Cohere API Configuration (REQUIRED)
+# ------------------------------------------------------------------------------
+# Obtain your API key from Cohere Dashboard: https://dashboard.cohere.com/api-keys
+COHERE_API_KEY=your_cohere_api_key_here
+
+# Cohere model identifiers
+COHERE_EMBED_MODEL=embed-english-v3.0
+COHERE_GENERATE_MODEL=command-nightly
+
+# ------------------------------------------------------------------------------
+# Application Configuration
+# ------------------------------------------------------------------------------
+APP_NAME=chainlearn-ai
+DEBUG=False
+LOG_LEVEL=INFO
+
+# ------------------------------------------------------------------------------
+# Knowledge Base & Embeddings
+# ------------------------------------------------------------------------------
+CHUNK_SIZE=500
+CHUNK_OVERLAP=50
+EMBEDDING_DIMENSIONS=1024
+INDEX_PATH=src/knowledge/data/index.json
+
+# ------------------------------------------------------------------------------
+# Text Generation Defaults
+# ------------------------------------------------------------------------------
+DEFAULT_MAX_TOKENS=2048
+DEFAULT_TEMPERATURE=0.7
+
+# ------------------------------------------------------------------------------
+# CORS Origins (JSON list or comma-separated URLs)
+# ------------------------------------------------------------------------------
+CORS_ORIGINS=["http://localhost:3000", "http://localhost:5173"]