# Environment Context

You are running on a **headless Ubuntu 24.04 VPS** at Hostinger (datacenter IP).

## Key Constraints

- **No browser, no GUI.** Headless cloud server. No X11, no Chromium, no `--cookies-from-browser`.
- **Datacenter IP is flagged.** YouTube and many services block cloud IPs. Use cookies or API keys.
- **Codex sandbox may restrict DNS.** If you can't resolve hostnames, write the code and note it needs live testing. Don't spin on network errors.

## Available in This Workspace

- Python 3.12 with venv at `.venv/` — activate: `source .venv/bin/activate`
- yt-dlp at `.venv/bin/yt-dlp`
- YouTube cookies at `cookies.txt` (Netscape format)
- Node.js 22 via NVM (source `$HOME/.nvm/nvm.sh` first)
- gh CLI at `~/.local/bin/gh`

## Install Packages Into the Venv

```bash
source .venv/bin/activate && pip install <package>
```

Do NOT install globally or use sudo for pip.