Files
foxhunt/services/ml_training_service
jgrusewski 74bf052738 refactor: rename duplicate ModelMetadata structs to unique names
8 structs shared the name ModelMetadata across the codebase. Renamed 7
domain-specific variants to descriptive names, keeping ml::ModelMetadata
as the canonical definition:

- model_loader: ModelMetadata → LoadedModelInfo
- config: ModelMetadata → ModelRegistryEntry
- trading_service: ModelMetadata → RuntimeModelInfo
- ml-data: ModelMetadata → ModelRecord
- adaptive-strategy: ModelMetadata → AdaptiveModelInfo
- storage: ModelMetadata → ModelStorageExtras
- tests/harness: ModelMetadata → TestModelMetrics

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 21:51:57 +01:00
..

ml_training_service

Model training orchestration and lifecycle management for the Foxhunt HFT trading system. Manages training jobs for DQN, PPO, TFT, Mamba2, TLOB, and Liquid models with progress tracking, resource allocation, and model artifact storage.

Building

# Default (minimal features)
cargo build --release -p ml_training_service

# With GPU acceleration (requires CUDA)
cargo build --release -p ml_training_service --features gpu

# With mock training data (testing only, bypasses database)
cargo build --release -p ml_training_service --features mock-data

Features

Feature Default Description
minimal Yes Minimal ML feature set for financial models
gpu No SIMD GPU acceleration (requires CUDA)
debug No Additional debug logging
mock-data No Use mock training data instead of PostgreSQL

Configuration

The gRPC listen port is set via the GRPC_PORT environment variable. Prometheus metrics are exposed on port 9094.

PostgreSQL (via sqlx) is used for job metadata, training history, and state management. Set the connection string with DATABASE_URL.

Running

GRPC_PORT=50053 DATABASE_URL="postgresql://user:pass@localhost:5432/foxhunt_training" \
  ./target/release/ml_training_service serve

Testing

# Unit tests (offline, no database required)
SQLX_OFFLINE=true cargo test -p ml_training_service --lib

# Integration tests (requires running PostgreSQL)
cargo test -p ml_training_service