Files
workspace/projects/feed-hunter/portal/README.md
Case 5ce3e812a1 Feed Hunter portal: dark theme dashboard on localhost:8888
- Web portal with 5 views: dashboard, feed, investigations, sims, status
- Enhanced triage with 40+ claim patterns
- Position monitor script
- Pipeline report generator
- Systemd service for portal
2026-02-08 00:06:24 -06:00

1.8 KiB

Feed Hunter Portal

Self-contained web dashboard for monitoring the X/Twitter feed intelligence pipeline.

Quick Start

The portal is already running at http://localhost:8888/

Views

  • Dashboard (/) - Overview of active simulations, recent scrapes, signal counts
  • Feed (/feed) - Latest scraped posts with triage status (color-coded)
  • Investigations (/investigations) - Detailed investigation reports
  • Simulations (/simulations) - Active paper positions, P&L, trade history
  • Status (/status) - Pipeline health, last run times, Chrome status

Management

Manual Control:

# Start portal
cd portal && python3 server.py

# Stop portal  
pkill -f "python3 server.py"

Systemd Service:

# Check status
systemctl --user status feed-hunter-portal

# Start/stop/restart
systemctl --user start feed-hunter-portal
systemctl --user stop feed-hunter-portal
systemctl --user restart feed-hunter-portal

# View logs
journalctl --user -u feed-hunter-portal -f

Features

  • Dark theme optimized for monitoring
  • Mobile-friendly responsive design
  • Real-time updates every 30 seconds on dashboard
  • Color-coded triage status (High Value = green, Investigate = orange, etc.)
  • P&L tracking with profit/loss indicators
  • No external dependencies - uses Python stdlib only

Data Sources

The portal reads from:

  • ../data/x-feed/*/posts.json - Scraped Twitter posts
  • ../data/x-feed/*/triage.json - Triage results
  • ../data/investigations/*.json - Investigation reports
  • ../data/simulations/active.json - Active paper positions
  • ../data/simulations/history.json - Closed trades
  • ../config.json - Pipeline configuration

Development

Single file architecture in server.py with embedded CSS/JS. Easy to modify and extend.