refactor: externalize hardcoded config to .env

- Remove hardcoded defaults from config.py, load via dotenv
- Deduplicate env vars in tracing.py (import from config)
- Add .env.example with sample values
- Update README.md and INSTALL.md to reference .env.example

Author: iamboyoungkim

eks-agentic-ai-platform/.env.example

@@ -0,0 +1,21 @@
+# =============================================================================
+# Agentic AI Platform — 앱 환경 설정 템플릿
+# cp .env.example .env 후 실제 값으로 수정하세요.
+# ⚠️ .env 파일은 .gitignore에 포함되어 있습니다. 절대 커밋하지 마세요.
+# =============================================================================
+
+# --- Bifrost Gateway ---
+BIFROST_ENDPOINT=http://bifrost.ai-inference.svc.cluster.local:8080/v1
+BIFROST_API_KEY=test-1234
+
+# --- Model names (Bifrost provider/model 형식) ---
+MODEL_SIMPLE=self-hosted-vllm/qwen3-8b
+MODEL_COMPLEX=bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0
+MODEL_DOCUMENT=self-hosted-vllm/qwen3-8b
+MODEL_CLASSIFIER=self-hosted-vllm/qwen3-8b
+MODEL_EVALUATOR=self-hosted-vllm/qwen3-8b
+
+# --- Langfuse (leave empty to disable tracing) ---
+LANGFUSE_SECRET_KEY=sk-lf-your-secret-key
+LANGFUSE_PUBLIC_KEY=pk-lf-your-public-key
+LANGFUSE_HOST=http://langfuse.observability.svc.cluster.local:3000

eks-agentic-ai-platform/INSTALL.md

@@ -644,14 +644,18 @@ source .venv/bin/activate
 
 ### 8.2 환경변수 설정
 
-`.env` 파일을 생성하여 환경변수를 관리합니다 (`.gitignore`에 추가 권장):
+`.env.example` 파일을 복사하여 실제 값으로 수정합니다 (`.env`는 `.gitignore`에 포함되어 있습니다):
 
 ```bash
-# .env
+cp .env.example .env
+```
+
+`.env` 파일을 열어 Langfuse API 키 등을 실제 값으로 수정합니다:
+
+```bash
+# .env (수정 필요한 항목)
 LANGFUSE_SECRET_KEY=sk-lf-your-secret-key
 LANGFUSE_PUBLIC_KEY=pk-lf-your-public-key
-LANGFUSE_BASE_URL=http://localhost:3000
-VLLM_URL=http://localhost:8000/v1
 ```
 
 Langfuse API 키는 Langfuse Web UI에서 발급받습니다:

eks-agentic-ai-platform/README.md

@@ -120,13 +120,10 @@ kubectl port-forward svc/langfuse-web 3000:3000 -n observability &
 python3 -m venv .venv && source .venv/bin/activate
 .venv/bin/pip install langchain_openai langgraph langfuse python-dotenv
 
-# .env 파일 생성
-cat > .env << 'EOF'
-LANGFUSE_SECRET_KEY=sk-lf-your-secret-key
-LANGFUSE_PUBLIC_KEY=pk-lf-your-public-key
-LANGFUSE_BASE_URL=http://localhost:3000
-VLLM_URL=http://localhost:8000/v1
-EOF
+# .env 파일 생성 (.env.example을 복사하여 실제 값으로 수정)
+cp .env.example .env
+# .env 파일을 열어 Langfuse API 키 등 실제 값으로 수정
+# vi .env
 
 # 실행
 .venv/bin/python demo.py

eks-agentic-ai-platform/app/config.py

@@ -1,18 +1,19 @@
 import os
 
+from dotenv import load_dotenv
+
+load_dotenv()
+
 # Bifrost Gateway
-BIFROST_ENDPOINT = os.getenv(
-    "BIFROST_ENDPOINT",
-    "http://bifrost.ai-inference.svc.cluster.local:8080/v1",
-)
-BIFROST_API_KEY = os.getenv("BIFROST_API_KEY", "test-1234")
+BIFROST_ENDPOINT = os.getenv("BIFROST_ENDPOINT")
+BIFROST_API_KEY = os.getenv("BIFROST_API_KEY")
 
-# Model names (환경변수로 오버라이드 가능)
-MODEL_SIMPLE = os.getenv("MODEL_SIMPLE", "qwen3-8b")
-MODEL_COMPLEX = os.getenv("MODEL_COMPLEX", "anthropic.claude-3-sonnet")
-MODEL_DOCUMENT = os.getenv("MODEL_DOCUMENT", "gpt-4o")
-MODEL_CLASSIFIER = os.getenv("MODEL_CLASSIFIER", "gpt-4o")
-MODEL_EVALUATOR = os.getenv("MODEL_EVALUATOR", "gpt-4o")
+# Model names
+MODEL_SIMPLE = os.getenv("MODEL_SIMPLE")
+MODEL_COMPLEX = os.getenv("MODEL_COMPLEX")
+MODEL_DOCUMENT = os.getenv("MODEL_DOCUMENT")
+MODEL_CLASSIFIER = os.getenv("MODEL_CLASSIFIER")
+MODEL_EVALUATOR = os.getenv("MODEL_EVALUATOR")
 
 # Classification-to-model mapping
 CLASSIFICATION_MODEL_MAP = {
@@ -24,7 +25,4 @@
 # Langfuse
 LANGFUSE_SECRET_KEY = os.getenv("LANGFUSE_SECRET_KEY", "")
 LANGFUSE_PUBLIC_KEY = os.getenv("LANGFUSE_PUBLIC_KEY", "")
-LANGFUSE_HOST = os.getenv(
-    "LANGFUSE_HOST",
-    "http://langfuse.observability.svc.cluster.local:3000",
-)
+LANGFUSE_HOST = os.getenv("LANGFUSE_HOST")

eks-agentic-ai-platform/app/tracing.py

@@ -4,12 +4,9 @@
 키가 없으면 no-op으로 동작하여 앱 로직에 영향을 주지 않습니다.
 """
 
-import os
 from contextlib import contextmanager
 
-LANGFUSE_SECRET_KEY = os.getenv("LANGFUSE_SECRET_KEY", "")
-LANGFUSE_PUBLIC_KEY = os.getenv("LANGFUSE_PUBLIC_KEY", "")
-LANGFUSE_HOST = os.getenv("LANGFUSE_HOST", "http://langfuse-web.observability.svc.cluster.local:3000")
+from app.config import LANGFUSE_SECRET_KEY, LANGFUSE_PUBLIC_KEY, LANGFUSE_HOST
 
 LANGFUSE_ENABLED = bool(LANGFUSE_SECRET_KEY and LANGFUSE_PUBLIC_KEY)