StyxAeon

A high-performance geolocation intelligence and telemetry fusion platform.

---

📡 What is StyxAeon?

StyxAeon (formerly StyxTracker) is a full-stack intelligence platform designed to ingest, enrich, and visualize field telemetry. It takes raw signal data (Cell towers, Wi-Fi networks, and GPS) and fuses them using an inverse-square weighted centroid algorithm to produce highly accurate geographic coordinates.

Core Capabilities

• Signal Fusion: Combines OpenCelliD and Google Geolocation APIs with device GPS.
• Analyst Console: A responsive React frontend with MapLibre GL for live geographic tracking.
• Case Management: Group telemetry sessions into operational cases.
• Watch automation: Trigger webhooks automatically when specific subjects move.
• Bulk Processing: Process thousands of CSV coordinate lookups asynchronously.

🚀 Getting Started

If you are new to the platform or want to run it locally, please read the setup guide:

👉 Read SETUP.md for installation instructions

🏗️ Architecture

The platform consists of two main components:

1. Python FastAPI Backend (/server.py)

   • High-concurrency async pipeline.
   • SQLite persistence in WAL mode for operations and intel storage.
   • Caching layer to prevent duplicate API lookups.

2. React Frontend (/frontend)

   • Built with Vite, React 19, and TypeScript.
   • Dual-theme support (Aurora Glass / Hacker Grid).
   • Interactive "Submission Lab" to test payloads.

🛡️ Telemetry Structure

StyxAeon expects field telemetry in the following JSON format:

{
  "cell_towers": [
    {
      "mcc": 404,
      "mnc": 45,
      "lac": 12034,
      "cell_id": 188231,
      "signal_dbm": -79,
      "is_serving": true
    }
  ],
  "wifi_networks": [
    {
      "bssid": "00:11:22:33:44:55",
      "ssid": "FieldOps-Relay",
      "rssi": -52
    }
  ]
}

🧪 Testing

To run the backend integration test suite (requires pytest):

python -m pytest tests/ -v

📜 License

Private / Confidential.