Merge pull request FinTechTonic#54 from FinTechTonic/quant

adds DSS

Author: Josephrp

.env.example

@@ -89,6 +89,84 @@ EMBEDDINGS_DEVICE=cpu
 #   '{"device":"cuda","model_kwargs":{"torch_dtype":"float16"}}' - GPU with float16
 EMBEDDINGS_MODEL_KWARGS=
 
+
+# =============================================================================
+# Web Search Service Configuration (for DeepResearch and PeopleHub)
+# =============================================================================
+# Serper API key for web search (get from https://serper.dev/)
+SERPER_API_KEY=
+
+# Rate limit for web search requests (format: "N/period", e.g., "360/hour")
+# Default: 360/hour (matches Serper free tier)
+WEB_SEARCH_RATE_LIMIT=360/hour
+
+# Directory for web search analytics data (request counts, timing)
+# Default: ./data/web_search_analytics (created automatically)
+WEB_SEARCH_ANALYTICS_DIR=
+
+# =============================================================================
+# Reranking Configuration (for search result reranking)
+# =============================================================================
+# Use local reranking model (True) or remote API (False)
+# Local: Uses sentence-transformers CrossEncoder (requires GPU/CPU resources)
+# Remote: Uses API-based reranking (e.g., Cohere, Jina)
+RERANKING_USE_LOCAL=true
+
+# Local reranking model identifier (HuggingFace model ID)
+# Default: BAAI/bge-reranker-base
+# Alternatives: BAAI/bge-reranker-large (better quality), cross-encoder/ms-marco-MiniLM-L-6-v2 (faster)
+RERANKING_MODEL=BAAI/bge-reranker-base
+
+# Device for local reranking: "cpu", "cuda", "cuda:0", etc.
+RERANKING_DEVICE=cpu
+
+# Remote reranking API URL (only needed if RERANKING_USE_LOCAL=false)
+# Examples:
+#   Cohere: https://api.cohere.ai/v1/rerank
+#   Jina: https://api.jina.ai/v1/rerank
+RERANKING_API_URL=
+
+# Remote reranking API key (only needed if using remote reranking)
+RERANKING_API_KEY=
+
+
+# =============================================================================
+# LangAlpha Quantitative Analysis Configuration
+# =============================================================================
+# Polygon.io API key for market data (get from https://polygon.io/)
+# Required for market data retrieval (OHLCV, ticker snapshots)
+POLYGON_API_KEY=
+
+# Alpha Vantage API key for fundamental data (get from https://www.alphavantage.co/support/#api-key)
+# Required for fundamental data retrieval (company overview, financial statements)
+ALPHA_VANTAGE_API_KEY=
+
+# LangAlpha LLM Model Configuration
+# Model for reasoning tasks (supervisor, planner, analyst)
+# Default: gpt-4o (OpenAI), can be overridden per provider
+LANGALPHA_REASONING_MODEL=gpt-4o
+
+# Model for basic tasks (researcher, reporter, market agent)
+# Default: gpt-4o-mini (OpenAI), can be overridden per provider
+LANGALPHA_BASIC_MODEL=gpt-4o-mini
+
+# Model for economic analysis tasks
+# Default: gpt-4o-mini (OpenAI), can be overridden per provider
+LANGALPHA_ECONOMIC_MODEL=gpt-4o-mini
+
+# Model for coding/calculation tasks (coder agent)
+# Default: gpt-4o (OpenAI), can be overridden per provider
+LANGALPHA_CODING_MODEL=gpt-4o
+
+# Budget level for LangAlpha agents
+# Options: "low" (uses economic models), "medium" (uses basic models), "high" (uses reasoning/coding models)
+# Default: medium
+# Low budget: All agents use economic model (cheapest)
+# Medium budget: All agents use basic model (balanced)
+# High budget: Agents use specialized models (most expensive, best quality)
+LANGALPHA_BUDGET_LEVEL=medium
+
+
 # =============================================================================
 # Sentinel Hub Configuration (for satellite imagery)
 # =============================================================================