CONFIDENTIAL A&R INFRASTRUCTURE – 2026 DEPLOYMENT
Consolidated Production Package (Phases 1–5 Complete)

PREDATOR_PRODUCTION contains the complete, battle-tested codebase for Agent PREDATOR and its Swarm. It ingests raw platform data from YouTube, Spotify, Shazam, and SoundCloud, calculates algorithmic velocity and comment density, enforces zero-bloat database maintenance, and routes high-priority viral trends directly to ClickUp.

Deploying with Docker is the fastest, cleanest method for Hetzner or any bare-metal Ubuntu Linux server.

• Docker Engine installed (docker --version)
• Docker Compose installed (docker-compose --version)

1. Clone/Copy Project: Upload PREDATOR_PRODUCTION to your server directory (e.g., /opt/predator).

2. Configure Environment Variables: Copy .env.example to .env:

   cp .env.example .env

   Edit .env to include your actual API keys and Webhook URLs:

   CLICKUP_API_KEY=pk_your_actual_clickup_api_key
   CLICKUP_LIST_ID=your_list_id
   CLICKUP_USER_ID_AYDEN=81352468
   DISCORD_LOGS_WEBHOOK_URL=https://discord.com/api/webhooks/...
   DISCORD_FATAL_WEBHOOK_URL=https://discord.com/api/webhooks/...

3. Initialize Database Tables:

   docker-compose run --rm predator_swarm python -m src.main --init-db

4. Launch the Swarm in Daemon Mode:

   docker-compose up -d

5. Check Container Logs:

   docker-compose logs -f predator_swarm

To run natively on Hetzner Ubuntu bare-metal:

1. Install System Dependencies:

   sudo apt update && sudo apt install -y python3-pip python3-venv postgresql redis-server git

2. Setup Virtual Environment & Dependencies:

   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt
   python3 -m playwright install chromium
   python3 -m playwright install-deps chromium

3. Initialize Database & Verify Environment:

   python3 -m src.main --init-db
   python3 -m src.main --mock-validation-phase5

4. Create Systemd Service (/etc/systemd/system/predator.service):

   [Unit]
   Description=Project Predator Swarm Daemon
   After=network.target postgresql.service redis-server.service
   
   [Service]
   Type=simple
   User=ubuntu
   WorkingDirectory=/opt/predator
   ExecStart=/opt/predator/.venv/bin/python -m src.main --daemon
   Restart=always
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target

5. Enable and Start Service:

   sudo systemctl daemon-reload
   sudo systemctl enable predator
   sudo systemctl start predator
   sudo systemctl status predator

You can run individual CLI operations or admin overrides at any time:

• Add VIP Channel:

  python -m src.main --admin-cmd "/vip add https://www.youtube.com/channel/UC_channel_id"

• Inject Search Keyword:

  python -m src.main --admin-cmd "/addkeyword hardstyle sped up"

• Run External Chart Sweep: python -m src.main --sweep-charts
• Process YouTube Search Queue: python -m src.main --process-queue
• Process 12H Hunts & Early Kills: python -m src.main --process-hunts
• Run ClickUp Task Drip Feed: python -m src.main --drip-feed

To verify full pipeline integrity in production:

python -m src.main --mock-validation-full

Or run the complete Pytest test suite:

pytest tests/test_full_suite.py -v

PREDATOR_PRODUCTION/
├── docker-compose.yml       # Production Docker orchestration (DB, Redis, App)
├── Dockerfile               # Production container image manifest
├── .env.example             # Environment template
├── requirements.txt         # Consolidated Python requirements
├── README.md                # Hosting & ops manual
├── src/
│   ├── main.py              # CLI & Daemon Orchestrator
│   ├── scoring.py           # 0-100 Predator Score Engine
│   ├── trend_logic.py       # Title Clustering & Format Counter-Strike
│   ├── health_monitor.py    # Fatal Alert Monitors & Hardware Ceiling
│   ├── admin_commands.py    # /vip add & /addkeyword Injections
│   ├── database_maintenance.py # 30-Day TTL Purge & Zero-Bloat Cleanup
│   ├── phase2_staging.py    # Self-learning dataset exporter
│   ├── redis_queue.py       # Redis drip-feed & DB fallback queue
│   ├── clickup.py           # ClickUp API, @mentions, Google Trends
│   ├── discord_alerts.py    # #swarm-logs & #swarm-fatal webhooks
│   ├── youtube_tracker.py   # Individual video metric scraper
│   ├── scrapers.py          # Spotify, Shazam, Beatport, Apple, YouTube Trending scrapers
│   ├── normalizer.py        # Base title extraction & Unicode text normalizer
│   └── database.py          # PostgreSQL / SQLite DB connection & migrations
└── tests/
    └── test_full_suite.py   # Full test suite covering all 5 phases