"Vibe-Trading: Your Personal Trading Agent"
Python ai-agentalgorithmic-tradingbacktestingfintechllmmcpmulti-agentpythonquantitative-financetrading
"""Single source of truth for all Vibe-Trading environment variable defaults.
This module defines Pydantic models for every environment variable consumed by
the Vibe-Trading agent, grouped by functional category. Each field carries the
correct type, default value, and env-var alias so that ``EnvConfig()`` with no
arguments reads from ``os.environ`` and applies the documented defaults.
The schema replaces the ~207 scattered ``os.getenv`` calls across 66 files with
a validated, typed, centrally-managed configuration layer.
Usage::
from src.config.env_schema import EnvConfig
cfg = EnvConfig() # reads os.environ, applies defaults
cfg.llm.timeout_seconds # 120
cfg.data.tushare_token # ""
"""
from __future__ import annotations
import os
import types
from enum import Enum
from typing import Annotated, Any, Literal, Union, get_args, get_origin
from pydantic import BaseModel, BeforeValidator, ConfigDict, Field, model_validator
__all__ = [
"EnvConfig",
"LLMConfig",
"DataConfig",
"APIConfig",
"SwarmConfig",
"AgentTuningConfig",
"PathConfig",
"OcrConfig",
"MemoryConfig",
]
# ---------------------------------------------------------------------------
# Boolean coercion helper
# ---------------------------------------------------------------------------
def _parse_env_bool(v: Any) -> Any:
"""Coerce environment string values to ``bool``.
Accepts ``"1"``, ``"true"``, ``"yes"``, ``"on"`` (case-insensitive) as
``True`` and ``"0"``, ``"false"``, ``"no"``, ``"off"``, ``""`` as ``False``.
Non-string values pass through for Pydantic's built-in coercion.
"""
if isinstance(v, str):
low = v.strip().lower()
if low in {"1", "true", "yes", "on"}:
return True
if low in {"0", "false", "no", "off", ""}:
return False
return v
EnvBool = Annotated[bool, BeforeValidator(_parse_env_bool)]
def _parse_responses_api_bool(v: Any) -> Any:
"""Enable Responses transport only for the documented literal ``true``."""
if isinstance(v, str):
return v.strip() == "true"
return v
ResponsesApiBool = Annotated[bool, BeforeValidator(_parse_responses_api_bool)]
def _numeric_type(annotation: Any) -> Any:
"""Return ``int``/``float`` for that type or an ``Optional`` of it, else ``None``.
Handles both ``typing.Optional[int]`` and the ``int | None`` spelling,
which produce different ``get_origin`` results (``typing.Union`` vs.
``types.UnionType``).
Args:
annotation: The field annotation resolved by Pydantic.
Returns:
Its numeric type, or ``None`` for annotations needing normal validation.
"""
if annotation is int or annotation is float:
return annotation
if get_origin(annotation) in (Union, types.UnionType):
args = [a for a in get_args(annotation) if a is not type(None)]
if len(args) == 1 and args[0] in (int, float):
return args[0]
return None
# ---------------------------------------------------------------------------
# Base class
# ---------------------------------------------------------------------------
class _EnvBase(BaseModel):
"""Base for environment-variable-backed config sub-models.
Each sub-model reads missing fields from ``os.environ`` using the field
alias (the UPPER_SNAKE_CASE env-var name). Explicit constructor arguments
always take precedence over environment values.
"""
model_config = ConfigDict(populate_by_name=True, extra="ignore")
@model_validator(mode="before")
@classmethod
def _load_from_env(cls, data: Any) -> Any:
"""Populate missing fields from ``os.environ`` using field aliases.
Invalid numeric env values are silently dropped so Pydantic applies
the field default instead of raising a ``ValidationError``.
"""
if not isinstance(data, dict):
return data
result = dict(data)
for field_name, field_info in cls.model_fields.items():
alias = field_info.alias
# Skip fields already provided (by Python name or alias).
if field_name in result or (alias and alias in result):
continue
# Read from environment using the UPPER_SNAKE_CASE alias.
if alias and alias in os.environ:
env_val = os.environ[alias]
# Safe coercion for numeric fields: drop unparseable values
# so Pydantic falls back to the field default.
numeric_type = _numeric_type(field_info.annotation)
if numeric_type is int and isinstance(env_val, str):
try:
env_val = int(env_val)
except ValueError:
continue
elif numeric_type is float and isinstance(env_val, str):
try:
env_val = float(env_val)
except ValueError:
continue
result[alias] = env_val
return result
# ---------------------------------------------------------------------------
# LLM Provider
# ---------------------------------------------------------------------------
class LLMConfig(_EnvBase):
"""LLM provider and generation parameters.
Sources: ``src/providers/llm.py``, ``src/providers/chat.py``,
``src/providers/openai_codex.py``, ``src/providers/claude_cli.py``,
``src/preflight.py``.
"""
langchain_provider: str = Field(alias="LANGCHAIN_PROVIDER", default="openai")
langchain_model_name: str = Field(alias="LANGCHAIN_MODEL_NAME", default="")
langchain_temperature: float = Field(alias="LANGCHAIN_TEMPERATURE", default=0.0)
# The native Anthropic credential. Read through bare ``os.getenv`` in
# ``llm.py``, which left it out of this schema — so ``provider doctor`` and
# preflight could not tell a missing key from a working one and the failure
# surfaced as an opaque 401 at the first call instead (#1223).
anthropic_api_key: str = Field(alias="ANTHROPIC_API_KEY", default="")
langchain_max_tokens: int | None = Field(
alias="LANGCHAIN_MAX_TOKENS", default=None, gt=0
)
anthropic_max_tokens: int | None = Field(alias="ANTHROPIC_MAX_TOKENS", default=None, gt=0)
timeout_seconds: int = Field(alias="TIMEOUT_SECONDS", default=120)
max_retries: int = Field(alias="MAX_RETRIES", default=2)
langchain_reasoning_effort: str = Field(alias="LANGCHAIN_REASONING_EFFORT", default="")
langchain_use_responses_api: ResponsesApiBool | None = Field(
alias="LANGCHAIN_USE_RESPONSES_API", default=None
)
vibe_trading_deepseek_adapter: str = Field(alias="VIBE_TRADING_DEEPSEEK_ADAPTER", default="auto")
moonshot_user_agent: str = Field(alias="MOONSHOT_USER_AGENT", default="")
openai_codex_base_url: str = Field(
alias="OPENAI_CODEX_BASE_URL",
default="https://chatgpt.com/backend-api/codex/responses",
)
claude_cli_path: str = Field(alias="CLAUDE_CLI_PATH", default="")
vibe_trading_deny_tool_prefixes: str | None = Field(
alias="VIBE_TRADING_DENY_TOOL_PREFIXES", default=None
)
vibe_trading_bash_policy: str | None = Field(
alias="VIBE_TRADING_BASH_POLICY", default=None
)
# A convenience filter, not a security boundary: live orders are still bound
# by the mandate gate whatever this list hides.
claude_cli_deny_tool_prefixes: str = Field(
alias="CLAUDE_CLI_DENY_TOOL_PREFIXES", default="trading_,etoro_"
)
claude_cli_bash_policy: str = Field(
alias="CLAUDE_CLI_BASH_POLICY", default="python-only"
)
openai_model: str = Field(alias="OPENAI_MODEL", default="")
vibe_trading_disable_http_proxy: EnvBool = Field(
alias="VIBE_TRADING_DISABLE_HTTP_PROXY", default=False,
)
vibe_trading_anthropic_prompt_cache: EnvBool = Field(
alias="VIBE_TRADING_ANTHROPIC_PROMPT_CACHE", default=True,
)
# ---------------------------------------------------------------------------
# Data Sources
# ---------------------------------------------------------------------------
class DataConfig(_EnvBase):
"""Market-data source credentials and tuning.
Sources: ``backtest/loaders/*.py``, ``src/tools/web_search_tool.py``,
``src/tools/iwencai_tool.py``, ``src/tools/fred_macro_tool.py``.
"""
tushare_token: str = Field(alias="TUSHARE_TOKEN", default="")
ccxt_exchange: str = Field(alias="CCXT_EXCHANGE", default="binance")
ccxt_timeout_ms: int = Field(alias="CCXT_TIMEOUT_MS", default=15000)
ccxt_fetch_budget_s: float = Field(alias="CCXT_FETCH_BUDGET_S", default=60.0)
futu_host: str = Field(alias="FUTU_HOST", default="127.0.0.1")
futu_port: int = Field(alias="FUTU_PORT", default=11111)
finnhub_api_key: str = Field(alias="FINNHUB_API_KEY", default="")
alphavantage_api_key: str = Field(alias="ALPHAVANTAGE_API_KEY", default="")
tiingo_api_key: str = Field(alias="TIINGO_API_KEY", default="")
fmp_api_key: str = Field(alias="FMP_API_KEY", default="")
gildata_features: str = Field(alias="VIBE_TRADING_GILDATA_FEATURES", default="")
gildata_token: str = Field(alias="GILDATA_TOKEN", default="")
gildata_base_url: str = Field(
alias="GILDATA_BASE_URL",
default="https://api.gildata.com/mcp-servers/aidata-assistant-srv-rawapi",
)
# Standard-version (srv-tool) NL research endpoint — see src/tools/gildata_srv.py.
gildata_srv_tool_url: str = Field(alias="GILDATA_SRV_TOOL_URL", default="")
fred_api_key: str = Field(alias="FRED_API_KEY", default="")
vibe_trading_iwencai_key: str = Field(alias="VIBE_TRADING_IWENCAI_KEY", default="")
vibe_trading_sec_ua: str = Field(alias="VIBE_TRADING_SEC_UA", default="")
# 13F scan bounds. No gt=0 constraint: a non-positive override must fall
# back to the default like any other bad value, and a constraint would
# raise a ValidationError at config load instead.
vibe_trading_sec_13f_max_xml_mb: float = Field(
alias="VIBE_TRADING_SEC_13F_MAX_XML_MB", default=25.0
)
vibe_trading_sec_13f_budget_s: float = Field(
alias="VIBE_TRADING_SEC_13F_BUDGET_S", default=120.0
)
vibe_trading_sec_ftd_url: str = Field(alias="VIBE_TRADING_SEC_FTD_URL", default="")
vibe_trading_sec_ftd_files: int = Field(alias="VIBE_TRADING_SEC_FTD_FILES", default=1)
vibe_trading_openalex_mailto: str = Field(alias="VIBE_TRADING_OPENALEX_MAILTO", default="")
vibe_tw_stock_db: str = Field(alias="VIBE_TW_STOCK_DB", default="")
# Brazilian official data (B3 COTAHIST, CVM, BCB, Tesouro Direto), synced
# by the one-off CLI ``python -m src.br_data sync`` or by the daily
# ``system:br-data-sync`` job (gated by ``vibe_br_sync_enabled`` below)
# into one SQLite file. Empty = default
# ``~/.vibe-trading/br-data/br_data.db``.
vibe_br_data_db: str = Field(alias="VIBE_BR_DATA_DB", default="")
# First COTAHIST year a sync downloads (B3 publishes from 1986).
vibe_br_cotahist_start_year: int = Field(alias="VIBE_BR_COTAHIST_START_YEAR", default=2015)
# First year of CVM fund daily reports / company filings a sync downloads.
vibe_br_cvm_start_year: int = Field(alias="VIBE_BR_CVM_START_YEAR", default=2022)
# Local time (HH:MM, America/Sao_Paulo) used as the cron slot for the
# FIRST seed of the daily sync system job (see ``vibe_br_sync_enabled``).
vibe_br_sync_time: str = Field(alias="VIBE_BR_SYNC_TIME", default="21:30")
# Opt-in gate for the protected daily-sync system job
# (``system:br-data-sync``), read via
# src/br_data/scheduling.py. Deliberately not part of any preset, so
# enabling the scheduler never silently seeds a daily network sync;
# VIBE_BR_SYNC_TIME above drives the first seed's cron slot.
vibe_br_sync_enabled: EnvBool = Field(
default=False, alias="VIBE_BR_SYNC_ENABLED",
description="Enable the daily br-data sync system job",
)
vibe_trading_data_cache: EnvBool = Field(alias="VIBE_TRADING_DATA_CACHE", default=False)
vibe_trading_data_cache_root: str = Field(alias="VIBE_TRADING_DATA_CACHE_ROOT", default="")
aliyun_iqs_api_key: str = Field(alias="ALIYUN_IQS_API_KEY", default="")
tickerall_api_key: str = Field(alias="TICKERALL_API_KEY", default="")
tickerall_account_id: str = Field(alias="TICKERALL_ACCOUNT_ID", default="")
tickerall_base_url: str = Field(alias="TICKERALL_BASE_URL", default="")
rsshub_base_url: str = Field(alias="RSSHUB_BASE_URL", default="")
dashscope_api_key: str = Field(alias="DASHSCOPE_API_KEY", default="")
longbridge_app_key: str = Field(alias="LONGBRIDGE_APP_KEY", default="")
longbridge_app_secret: str = Field(alias="LONGBRIDGE_APP_SECRET", default="")
longbridge_access_token: str = Field(alias="LONGBRIDGE_ACCESS_TOKEN", default="")
etoro_api_key: str = Field(alias="ETORO_API_KEY", default="")
etoro_user_key: str = Field(alias="ETORO_USER_KEY", default="")
# Per-market source-order overrides (Settings page "source priority").
# Value: comma-separated permutation of the market's default chain, e.g.
# MARKET_DATA_ORDER_A_SHARE=tushare,tencent,eastmoney,... Applied by
# backtest.loaders.registry.refresh_source_order_overrides() (which reads
# os.getenv directly); declared here for visibility/validation parity.
market_data_order_a_share: str = Field(alias="MARKET_DATA_ORDER_A_SHARE", default="")
market_data_order_us_equity: str = Field(alias="MARKET_DATA_ORDER_US_EQUITY", default="")
market_data_order_hk_equity: str = Field(alias="MARKET_DATA_ORDER_HK_EQUITY", default="")
market_data_order_india_equity: str = Field(alias="MARKET_DATA_ORDER_INDIA_EQUITY", default="")
market_data_order_kr_equity: str = Field(alias="MARKET_DATA_ORDER_KR_EQUITY", default="")
market_data_order_ca_equity: str = Field(alias="MARKET_DATA_ORDER_CA_EQUITY", default="")
market_data_order_ar_equity: str = Field(alias="MARKET_DATA_ORDER_AR_EQUITY", default="")
market_data_order_br_equity: str = Field(alias="MARKET_DATA_ORDER_BR_EQUITY", default="")
market_data_order_uk_equity: str = Field(alias="MARKET_DATA_ORDER_UK_EQUITY", default="")
market_data_order_vietnam_equity: str = Field(alias="MARKET_DATA_ORDER_VIETNAM_EQUITY", default="")
market_data_order_crypto: str = Field(alias="MARKET_DATA_ORDER_CRYPTO", default="")
market_data_order_futures: str = Field(alias="MARKET_DATA_ORDER_FUTURES", default="")
market_data_order_fund: str = Field(alias="MARKET_DATA_ORDER_FUND", default="")
market_data_order_macro: str = Field(alias="MARKET_DATA_ORDER_MACRO", default="")
market_data_order_forex: str = Field(alias="MARKET_DATA_ORDER_FOREX", default="")
market_data_order_index: str = Field(alias="MARKET_DATA_ORDER_INDEX", default="")
# ---------------------------------------------------------------------------
# OCR
# ---------------------------------------------------------------------------
class OcrConfig(_EnvBase):
"""OCR engine selection and model configuration.
Sources: ``src/tools/ocr/engine.py``, ``src/tools/ocr/llm_vision_ocr.py``.
"""
vibe_trading_ocr_engine: str = Field(alias="VIBE_TRADING_OCR_ENGINE", default="auto")
vibe_trading_ocr_llm_model: str = Field(alias="VIBE_TRADING_OCR_LLM_MODEL", default="")
@model_validator(mode="before")
@classmethod
def _alias_legacy_env_vars(cls, data: dict) -> dict:
"""Backward compat: VIBE_TRADING_OCR_QWEN_MODEL → VIBE_TRADING_OCR_LLM_MODEL.
Issue #547 requires a deprecation warning when the legacy env var is
present. Pydantic alias validation runs before field assignment, so we
read the old env var here and forward it to the new field.
"""
import logging
old_val = os.getenv("VIBE_TRADING_OCR_QWEN_MODEL", "")
new_val = (
data.get("vibe_trading_ocr_llm_model")
or os.getenv("VIBE_TRADING_OCR_LLM_MODEL", "")
)
if old_val and not new_val:
logging.getLogger(__name__).warning(
"VIBE_TRADING_OCR_QWEN_MODEL is deprecated; "
"use VIBE_TRADING_OCR_LLM_MODEL instead. "
"Alias will be removed in a future release."
)
data["vibe_trading_ocr_llm_model"] = old_val
return data
# ---------------------------------------------------------------------------
# API Server
# ---------------------------------------------------------------------------
class APIConfig(_EnvBase):
"""API server authentication, CORS, and security toggles.
Sources: ``src/api/security.py``, ``src/api/state.py``,
``mcp_server.py``, ``src/tools/path_utils.py``.
"""
api_auth_key: str = Field(alias="API_AUTH_KEY", default="")
vibe_trading_api_key: str = Field(alias="VIBE_TRADING_API_KEY", default="")
cors_origins: str = Field(alias="CORS_ORIGINS", default="")
# Additive, unlike CORS_ORIGINS: these origins are appended to the loopback
# defaults instead of replacing them. Used to admit a hosted console (e.g.
# OpenBB Workspace) without discarding the local-dev origins.
vibe_trading_extra_cors_origins: str = Field(
alias="VIBE_TRADING_EXTRA_CORS_ORIGINS", default="",
)
api_allowed_hosts: str = Field(alias="API_ALLOWED_HOSTS", default="")
# Comma-separated Host/Origin allow-list for the network MCP transports
# (--transport sse / http). Empty means loopback-only (127.0.0.1,
# localhost), which blocks DNS-rebinding while keeping local use working.
vibe_trading_mcp_allowed_hosts: str = Field(
alias="VIBE_TRADING_MCP_ALLOWED_HOSTS", default="",
)
enable_session_runtime: EnvBool = Field(alias="ENABLE_SESSION_RUNTIME", default=True)
vibe_trading_trust_docker_loopback: EnvBool = Field(
alias="VIBE_TRADING_TRUST_DOCKER_LOOPBACK", default=False,
)
# Ship the Content-Security-Policy as Report-Only instead of enforcing it.
# The policy is enforced by default; this is a rollback switch for a
# deployment that serves extra assets the stock policy does not cover
# (a reverse proxy injecting a script, a customized frontend build).
vibe_trading_csp_report_only: EnvBool = Field(
alias="VIBE_TRADING_CSP_REPORT_ONLY", default=False,
)
vibe_trading_enable_shell_tools: EnvBool = Field(
alias="VIBE_TRADING_ENABLE_SHELL_TOOLS", default=False,
)
vibe_trading_allowed_file_roots: str = Field(
alias="VIBE_TRADING_ALLOWED_FILE_ROOTS", default="",
)
vibe_trading_allowed_write_roots: str = Field(
alias="VIBE_TRADING_ALLOWED_WRITE_ROOTS", default="",
)
vibe_trading_allowed_run_roots: str = Field(
alias="VIBE_TRADING_ALLOWED_RUN_ROOTS", default="",
)
vibe_trading_api_url: str = Field(
alias="VIBE_TRADING_API_URL", default="http://127.0.0.1:8000",
)
futu_trade_pwd_md5: str = Field(alias="FUTU_TRADE_PWD_MD5", default="")
# ---------------------------------------------------------------------------
# Swarm
# ---------------------------------------------------------------------------
class SwarmConfig(_EnvBase):
"""Multi-agent swarm execution parameters.
Sources: ``src/swarm/worker.py``, ``src/tools/swarm_tool.py``,
``src/swarm/runtime.py``, ``src/swarm/grounding.py``.
"""
swarm_worker_timeout: int = Field(alias="SWARM_WORKER_TIMEOUT", default=300)
swarm_worker_max_iter: int = Field(alias="SWARM_WORKER_MAX_ITER", default=50)
swarm_max_workers: int = Field(alias="SWARM_MAX_WORKERS", default=4)
swarm_timeout: int = Field(alias="SWARM_TIMEOUT", default=1800)
swarm_heartbeat_interval_s: float = Field(alias="SWARM_HEARTBEAT_INTERVAL_S", default=3.0)
swarm_stream_retry_delay_s: float = Field(alias="SWARM_STREAM_RETRY_DELAY_S", default=1.0)
swarm_stream_retry_max_delay_s: float = Field(
alias="SWARM_STREAM_RETRY_MAX_DELAY_S", default=30.0, ge=0
)
swarm_worker_retry_base_delay_s: float = Field(
alias="SWARM_WORKER_RETRY_BASE_DELAY_S", default=1.0, ge=0
)
swarm_worker_retry_max_delay_s: float = Field(
alias="SWARM_WORKER_RETRY_MAX_DELAY_S", default=30.0, ge=0
)
swarm_grounding_max_symbols: int = Field(alias="SWARM_GROUNDING_MAX_SYMBOLS", default=8)
@model_validator(mode="after")
def _validate_retry_delays(self) -> SwarmConfig:
if self.swarm_worker_retry_max_delay_s < self.swarm_worker_retry_base_delay_s:
raise ValueError(
"SWARM_WORKER_RETRY_MAX_DELAY_S must be greater than or equal to "
"SWARM_WORKER_RETRY_BASE_DELAY_S"
)
if self.swarm_stream_retry_max_delay_s < self.swarm_stream_retry_delay_s:
raise ValueError(
"SWARM_STREAM_RETRY_MAX_DELAY_S must be greater than or equal to "
"SWARM_STREAM_RETRY_DELAY_S"
)
return self
# ---------------------------------------------------------------------------
# Agent Tuning
# ---------------------------------------------------------------------------
class AgentTuningConfig(_EnvBase):
"""Agent loop tuning, content-filter, scheduler, and feature flags.
Sources: ``src/agent/loop.py``, ``src/providers/content_filter.py``,
``src/scheduled_research/executor.py``, ``src/live/order_guard.py``,
``src/factors/_backend.py``, ``src/factors/bench_runner.py``,
``src/tools/web_search_tool.py``, ``api_server.py``.
"""
# Deprecated: counted chars/4 of messages without tool schemas, so no value
# tuned against it means anything under real-token accounting. Read only to
# warn (src/agent/context_budget.py); compaction ignores it.
token_threshold: int = Field(alias="TOKEN_THRESHOLD", default=40000)
# ReAct loop iteration cap for interactive/web sessions. Heavy pipelines
# (multi-layer scoring, batch research) legitimately exceed 50 turns.
vibe_trading_agent_max_iterations: int = Field(
alias="VIBE_TRADING_AGENT_MAX_ITERATIONS", default=50, ge=1,
)
vibe_trading_tool_loading: Literal["eager", "lazy"] = Field(
alias="VIBE_TRADING_TOOL_LOADING", default="lazy",
)
vibe_trading_context_window: int | None = Field(
alias="VIBE_TRADING_CONTEXT_WINDOW", default=None, gt=0,
)
# Cost ceiling on the prompt the loop lets a run grow to before compacting,
# whatever the model's window. The largest healthy research run measured
# on 2026-09-29 sent 154K real input tokens.
vibe_trading_context_max_tokens: int = Field(
alias="VIBE_TRADING_CONTEXT_MAX_TOKENS", default=200_000, gt=0,
)
vt_heartbeat_interval_s: float = Field(alias="VT_HEARTBEAT_INTERVAL_S", default=3.0)
vt_reasoning_delta_min_interval_s: float = Field(
alias="VT_REASONING_DELTA_MIN_INTERVAL_S", default=1.0,
)
vt_stream_retry_delay_s: float = Field(alias="VT_STREAM_RETRY_DELAY_S", default=1.0)
vt_stream_retry_max_delay_s: float = Field(
alias="VT_STREAM_RETRY_MAX_DELAY_S", default=30.0, ge=0
)
vibe_trading_tool_timeout_seconds: float = Field(
alias="VIBE_TRADING_TOOL_TIMEOUT_SECONDS", default=1800.0,
)
vibe_trading_llm_timeout_seconds: float = Field(
alias="VIBE_TRADING_LLM_TIMEOUT_SECONDS", default=300.0,
)
vibe_trading_run_stall_timeout_seconds: float = Field(
alias="VIBE_TRADING_RUN_STALL_TIMEOUT_SECONDS", default=1800.0,
)
vibe_trading_goal_max_continuations: int = Field(
alias="VIBE_TRADING_GOAL_MAX_CONTINUATIONS", default=3,
)
vibe_trading_sse_timeout: int = Field(alias="VIBE_TRADING_SSE_TIMEOUT", default=90)
content_filter_warning_threshold: float = Field(
alias="CONTENT_FILTER_WARNING_THRESHOLD", default=0.05,
)
vibe_trading_enable_advisory: EnvBool = Field(
alias="VIBE_TRADING_ENABLE_ADVISORY", default=False,
)
vibe_trading_enable_scheduler: EnvBool = Field(
alias="VIBE_TRADING_ENABLE_SCHEDULER", default=False,
)
vibe_contextual_identity_constraints: EnvBool = Field(
alias="VIBE_CONTEXTUAL_IDENTITY_CONSTRAINTS", default=True,
)
vibe_trading_scheduler_max_consecutive_failures: int = Field(
alias="VIBE_TRADING_SCHEDULER_MAX_CONSECUTIVE_FAILURES", default=3,
)
vibe_trading_scheduler_retry_base_delay_ms: int = Field(
alias="VIBE_TRADING_SCHEDULER_RETRY_BASE_DELAY_MS", default=60_000,
)
vibe_trading_scheduler_retry_max_delay_ms: int = Field(
alias="VIBE_TRADING_SCHEDULER_RETRY_MAX_DELAY_MS", default=3_600_000,
)
vibe_trading_channels_auto_start: EnvBool = Field(
alias="VIBE_TRADING_CHANNELS_AUTO_START", default=False,
)
vibe_trading_disable_bottleneck: EnvBool = Field(
alias="VIBE_TRADING_DISABLE_BOTTLENECK", default=False,
)
vibe_trading_bench_workers: int = Field(alias="VIBE_TRADING_BENCH_WORKERS", default=0)
vibe_trading_search_backends: str = Field(alias="VIBE_TRADING_SEARCH_BACKENDS", default="")
vibe_trading_search_parallel: EnvBool = Field(
alias="VIBE_TRADING_SEARCH_PARALLEL", default=False,
)
vibe_trading_slash_arg_max: int = Field(alias="VIBE_TRADING_SLASH_ARG_MAX", default=600)
vibe_trading_search_bing_fallback: EnvBool = Field(
alias="VIBE_TRADING_SEARCH_BING_FALLBACK", default=True,
)
vibe_live_authorize_timeout_s: int = Field(
alias="VIBE_LIVE_AUTHORIZE_TIMEOUT_SECONDS", default=300,
)
@model_validator(mode="after")
def _validate_stream_retry_delays(self) -> AgentTuningConfig:
if self.vt_stream_retry_max_delay_s < self.vt_stream_retry_delay_s:
raise ValueError(
"VT_STREAM_RETRY_MAX_DELAY_S must be greater than or equal to "
"VT_STREAM_RETRY_DELAY_S"
)
return self
# ---------------------------------------------------------------------------
# Paths
# ---------------------------------------------------------------------------
class PathConfig(_EnvBase):
"""File-system path overrides and session-level MCP trust.
Sources: ``src/hypotheses/registry.py``, ``src/goal/store.py``,
``src/config/loader.py``.
"""
vibe_trading_hypotheses_path: str = Field(alias="VIBE_TRADING_HYPOTHESES_PATH", default="")
vibe_trading_goal_db_path: str = Field(alias="VIBE_TRADING_GOAL_DB_PATH", default="")
vibe_trading_research_artifact_db_path: str = Field(
alias="VIBE_TRADING_RESEARCH_ARTIFACT_DB_PATH", default="",
)
vibe_trading_playbook_dir: str = Field(alias="VIBE_TRADING_PLAYBOOK_DIR", default="")
vibe_trading_swarm_agent_config: str = Field(
alias="VIBE_TRADING_SWARM_AGENT_CONFIG", default="",
)
allow_session_mcp_servers: EnvBool = Field(alias="ALLOW_SESSION_MCP_SERVERS", default=False)
vibe_trading_theme: str = Field(alias="VIBE_TRADING_THEME", default="")
vibe_goal_session_id: str = Field(alias="VIBE_GOAL_SESSION_ID", default="")
vibe_trading_strategy_store_db_path: str = Field(
alias="VIBE_TRADING_STRATEGY_STORE_DB_PATH", default="",
)
vibe_trading_strategy_discovery_db_path: str = Field(
alias="VIBE_TRADING_STRATEGY_DISCOVERY_DB_PATH", default="",
)
# ---------------------------------------------------------------------------
# Memory
# ---------------------------------------------------------------------------
class _MemoryPreset(str, Enum):
"""Business-friendly memory system presets."""
OFF = "off" # All features disabled
ON = "on" # Tier 1: quality + decay + gc
FULL = "full" # Tier 1 + Tier 2: all features
_PRESET_FLAGS: dict[str, dict[str, bool]] = {
"off": {
"quality_enabled": False,
"gc_enabled": False,
"decay_enabled": False,
"hierarchy_enabled": False,
"links_enabled": False,
"compression_enabled": False,
"fts_index_enabled": False,
},
"on": {
"quality_enabled": True,
"gc_enabled": True,
"decay_enabled": True,
"hierarchy_enabled": False,
"links_enabled": False,
"compression_enabled": False,
"fts_index_enabled": False,
},
"full": {
"quality_enabled": True,
"gc_enabled": True,
"decay_enabled": True,
"hierarchy_enabled": True,
"links_enabled": True,
"compression_enabled": True,
"fts_index_enabled": True,
},
}
# Mapping from field name to environment variable alias
_MEMORY_FLAG_ALIASES: dict[str, str] = {
"quality_enabled": "VT_MEMORY_QUALITY",
"gc_enabled": "VT_MEMORY_GC",
"decay_enabled": "VT_MEMORY_DECAY",
"hierarchy_enabled": "VT_MEMORY_HIERARCHY",
"links_enabled": "VT_MEMORY_LINKS",
"compression_enabled": "VT_MEMORY_COMPRESSION",
"fts_index_enabled": "VT_MEMORY_FTS_INDEX",
}
class MemoryConfig(_EnvBase):
"""Memory lifecycle feature flags.
Use VT_MEMORY=off|on|full as a business-friendly preset.
Individual VT_MEMORY_* flags can override the preset baseline.
"""
# Preset: business-friendly one-liner
preset: str = Field(default="off", alias="VT_MEMORY")
# Tier 1 flags
quality_enabled: EnvBool = Field(
default=False,
alias="VT_MEMORY_QUALITY",
description="Enable quality scoring and reinforcement",
)
gc_enabled: EnvBool = Field(
default=False,
alias="VT_MEMORY_GC",
description="Enable garbage collection cycle",
)
decay_enabled: EnvBool = Field(
default=False,
alias="VT_MEMORY_DECAY",
description="Enable importance decay computation",
)
# Tier 2 flags
hierarchy_enabled: EnvBool = Field(
default=False, alias="VT_MEMORY_HIERARCHY",
description="Enable hierarchical directory routing",
)
links_enabled: EnvBool = Field(
default=False, alias="VT_MEMORY_LINKS",
description="Enable BM25 semantic linking",
)
compression_enabled: EnvBool = Field(
default=False, alias="VT_MEMORY_COMPRESSION",
description="Enable auto-compression pipeline",
)
fts_index_enabled: EnvBool = Field(
default=False, alias="VT_MEMORY_FTS_INDEX",
description="Enable SQLite FTS5 search index",
)
# Scheduled consolidation system job (scheduler unification).
# Deliberately NOT listed in the preset flag map or the memory flag alias
# map above: the preset machinery only touches fields in the alias map, so
# VT_MEMORY=on/full can never silently enable a background timer. This
# flag is opt-in on its own; the job it gates also no-ops honestly unless
# VT_MEMORY_GC is enabled (see src/memory/consolidation.py).
consolidation_enabled: EnvBool = Field(
default=False, alias="VT_MEMORY_CONSOLIDATION",
description="Enable the daily memory-consolidation system job",
)
@model_validator(mode="before")
@classmethod
def _apply_preset(cls, data: Any) -> Any:
"""Apply VT_MEMORY preset as baseline; explicit flags override."""
if not isinstance(data, dict):
return data
# Determine preset value from env or constructor data
preset_val = (
os.environ.get("VT_MEMORY")
or data.get("VT_MEMORY")
or data.get("preset")
or "off"
)
preset_val = preset_val.strip().lower()
if preset_val not in _PRESET_FLAGS:
preset_val = "off"
baseline = _PRESET_FLAGS[preset_val]
# For each flag: use explicit env var if set, otherwise apply preset
for field_name, env_alias in _MEMORY_FLAG_ALIASES.items():
# If user explicitly set this env var, don't override
if os.environ.get(env_alias) is not None:
continue
# If explicitly passed in constructor data, don't override
if field_name in data or env_alias in data:
continue
# Apply preset baseline using field name
data[field_name] = baseline[field_name]
return data
# ---------------------------------------------------------------------------
# Top-level composition
# ---------------------------------------------------------------------------
class EnvConfig(_EnvBase):
"""Root configuration model composing all environment variable groups.
Instantiating with no arguments reads every recognised env var from
``os.environ`` and applies the documented defaults for missing values::
cfg = EnvConfig()
cfg.llm.timeout_seconds # 120
cfg.swarm.swarm_timeout # 1800
"""
llm: LLMConfig = Field(default_factory=LLMConfig)
data: DataConfig = Field(default_factory=DataConfig)
api: APIConfig = Field(default_factory=APIConfig)
swarm: SwarmConfig = Field(default_factory=SwarmConfig)
agent_tuning: AgentTuningConfig = Field(default_factory=AgentTuningConfig)
paths: PathConfig = Field(default_factory=PathConfig)
ocr: OcrConfig = Field(default_factory=OcrConfig)
memory: MemoryConfig = Field(default_factory=MemoryConfig)
@model_validator(mode="after")
def _resolve_api_key_alias(self) -> "EnvConfig":
"""Copy ``VIBE_TRADING_API_KEY`` to ``api_auth_key`` when only the alias is set.
The CLI historically reads ``VIBE_TRADING_API_KEY`` first and falls back to
``API_AUTH_KEY`` (``cli/_legacy.py:2834``). The API server only reads
``API_AUTH_KEY`` (``src/api/security.py:126``). This validator closes
the semantic gap so both surfaces agree.
"""
if self.api.vibe_trading_api_key and not self.api.api_auth_key:
self.api.api_auth_key = self.api.vibe_trading_api_key
return self