requirements.txt

# ============================================================================
# Crucible Review — Python Dependencies
# ============================================================================
# Install: pip install -r requirements.txt
#
# Packages marked "Optional" are imported with try/except and the system
# degrades gracefully if they are absent.  Install them only when you enable
# the corresponding feature flag.
# ============================================================================

# --- Core (always required) -------------------------------------------------
# v1.1.2 (sixth-pass M-11): minimum-version bounds on the core dependencies
# so the CI ``actions/setup-python`` cache key (hash of requirements.txt) is
# at least semantically meaningful — without any pins, the same content hash
# could resolve to wildly different installed versions across CI runs and
# ``pip-audit`` results would be non-reproducible from one PR to the next.
# Upper bounds are deliberately omitted on the core deps to stay compatible
# with the rolling-release model of crewai / langchain; pinning a lock file
# for full reproducibility is tracked separately (would require ``pip-compile``
# in a follow-up).  These floors reflect the API surfaces actually consumed
# by the codebase (httpx ``follow_redirects=`` kwarg, pydantic v2 model
# validators, flask ``stream_with_context``, etc.).
crewai>=0.30
langchain-openai>=0.1
litellm>=1.30
pydantic>=2.0
httpx>=0.24

# --- Token counting / context budget ----------------------------------------
# Used by context_budget.py and context_pressure.py for accurate token counts.
tiktoken>=0.5

# --- .env loading (runtime configuration) -----------------------------------
# Used by crucible/runtime_logging.py to honour CRUCIBLE_LOG_LEVEL
# and other env vars defined in the project-root ``.env`` file at startup.
# Optional — operators who export their env vars from the shell will see
# the same behaviour as before if this package is absent (the runtime
# falls back silently with try/except ImportError).
#
# v1.1.9 (M2): the optional dependency block below also carries minimum
# floors so ``pip-audit`` and the actions/setup-python cache key stay
# semantically meaningful.  Floors reflect the public-API surface actually
# consumed by the codebase and intentionally stay one or two majors back
# from the latest release to avoid forcing pointless upgrades on operators
# who already have a working install.
python-dotenv>=1.0

# --- YAML parsing (project profile) -----------------------------------------
pyyaml>=6.0

# --- Platform directory resolution ------------------------------------------
appdirs>=1.4

# --- Optional — backtest runner data fetching --------------------------------
# Install if using --backtest-runner
yfinance>=0.2.0
ccxt>=4.0

# --- Optional — Bayesian hyperparameter optimisation -------------------------
# Install if using BACKTEST_PARAM_SEARCH=bayesian
optuna>=3.0

# --- Optional — PDF report export --------------------------------------------
# Falls back to pure-stdlib writer if absent.
fpdf2>=2.7

# --- Optional — PDF / Word document ingestion --------------------------------
# Install if using --ingest-docs with PDF or DOCX files.
pypdf>=3.0
python-docx>=0.8.11

# --- Optional — project memory (vector database) ----------------------------
# Install if using --use-memory
chromadb>=0.4

# --- Optional — semantic deduplication ---------------------------------------
# Install if using ENHANCED_DEDUP_ENABLED=true
scikit-learn>=1.0

# --- Optional — file system watch mode ---------------------------------------
# Install if using the watch subcommand
watchdog>=3.0

# --- Optional — MLflow experiment tracking -----------------------------------
# Install if using MLFLOW_TRACKING_URI
mlflow>=2.0

# --- Optional — Quant Analytics Suite ----------------------------------------
# All fall back to pure-stdlib implementations if absent.
scipy>=1.7            # improves statistical significance tests (t-dist CDF, normal CDF)
statsmodels>=0.14     # used by factor_analyzer for OLS diagnostics if available
pandas-datareader>=0.10  # enables Fama-French factor data download (factor_analyzer --ff-data)
quantstats>=0.0.59    # tearsheet HTML rendering enhancement (falls back to pure Markdown)

# --- Optional — distributed tracing / observability --------------------------
# Install if using OTEL_EXPORTER_OTLP_ENDPOINT
opentelemetry-api>=1.20
opentelemetry-sdk>=1.20
opentelemetry-exporter-otlp>=1.20

# --- Optional — web UI -------------------------------------------------------
flask>=2.3

# --- Optional — extended feature modules -------------------------------------
# scheduler.py: built-in APScheduler job scheduling
APScheduler>=3.10

# redis_cache.py: Redis-backed research result cache
redis>=4.0

# prometheus_exporter.py: push metrics to Prometheus Pushgateway
prometheus_client>=0.15

# auth_manager.py: JWT authentication for WebUI
PyJWT>=2.0
bcrypt>=4.0

# celery_worker.py: distributed task queue
celery>=5.0

# chat_bot.py: Telegram and Discord bot interfaces
python-telegram-bot>=20.0
discord.py>=2.0

# notion_export.py: Notion API integration
# (uses stdlib urllib — no extra dep required)

# trading_platform.py: Interactive Brokers adapter
# ibapi  # install manually: pip install ibapi (not on PyPI by default)

# type_coverage.py: type annotation analysis (mypy optional)
# mypy  # install manually if TYPE_COVERAGE_RUN_MYPY=1