# Foxhunt RunPod Module - Quick Start

## Installation (Required)

```bash
cd /home/jgrusewski/Work/foxhunt/ml/python/foxhunt_runpod
pip install -r requirements.txt
```

## Verify Installation

```bash
python /home/jgrusewski/Work/foxhunt/ml/python/test_module_import.py
```

Expected output:
```
Testing foxhunt_runpod module imports...
1. Importing main module...
   ✓ Version: 1.0.0
...
✅ All imports successful!
```

## Deploy Pod (Example)

```python
from foxhunt_runpod import RunPodClient, PodMonitor

# 1. Deploy pod (auto-selects cheapest GPU ≥16GB VRAM)
client = RunPodClient()
pod = client.deploy_pod(
    gpu_type="RTX A4000",  # Optional: preferred GPU
    command="--parquet-file /runpod-volume/test_data/ES_FUT_180d.parquet --epochs 50"
)

# 2. Monitor training (S3 log tailing)
monitor = PodMonitor(pod['id'])
monitor.wait_until_running(timeout=300)  # Wait for pod to start
monitor.stream_s3_logs(follow=True)      # Stream logs until completion

# 3. Auto-terminate on completion
monitor.auto_terminate()
```

## Run Examples

```bash
python /home/jgrusewski/Work/foxhunt/ml/python/foxhunt_runpod/example_usage.py
```

Select from 5 examples:
1. Deploy and Monitor Training
2. List Available GPUs
3. List All Pods
4. S3 Operations
5. Monitor Existing Pod

## Configuration

Configuration is loaded from `/home/jgrusewski/Work/foxhunt/.env.runpod` (already configured).

## Documentation

- **Complete Guide**: `README.md`
- **Implementation Details**: `/home/jgrusewski/Work/foxhunt/RUNPOD_PYTHON_MODULE_IMPLEMENTATION.md`
- **Examples**: `example_usage.py`

## Key Features

- ✅ S3 log monitoring (NO SSH required)
- ✅ Automatic GPU selection by price
- ✅ Retry logic with exponential backoff
- ✅ Auto-termination on training completion
- ✅ Rich terminal output
- ✅ Type-safe with pydantic