Team: Witch Delivery Assosiates
Team Members: Leonid Mateush, Arjun Vishal, Zoë Bryant ,and Daniel Nguyen
Event: HackUTD 2025 "Lost in the Pages"
Challenge: EOGs - CauldronWatch: The Potion Flow Monitoring Challenge
Requirements and Setup
- Install Dependencies
Run this command first:
pip install -r requirements.txt
- Clone and Launch Go to a new folder and run this in terminal:
git clone https://github.com/Leoxoo/HackUTD2025
streamlit run app.py
Project Overview Witch Delivery Associates is a real-time data visualization dashboard built with Streamlit for the HackUTD 2025 EOG Resources: CauldronWatch challenge.It connects to the official EOG Systems API to monitor potion flow across cauldrons, track witch courier tickets, and detect discrepancies in potion collection and transport. The system allows users to:
- Monitor cauldron fill and drain levels
- Visualize real-time potion volume on an interactive map
- Track courier (witch) ticket transactions
- Detect missing or fraudulent collections
Tech Stack Layer Technologies Frontend Streamlit, Plotly Express, Plotly Graph Objects Backend / Data Python, Pandas, Requests Styling / UI HTML, CSS, Hydralit Components Visualization Progress Bars, Mapbox, Animated Playback
APIs Used Endpoint Purpose /api/Information/cauldrons Metadata for each cauldron (name, volume, location) /api/Data/?start_date=&end_date= Time-series potion level data /api/Data/metadata Sampling intervals and units /api/Tickets Witch courier ticket logs /api/Information/market Market location data
Key Features Live Cauldron Map Displays real-time potion levels across all cauldrons using Mapbox. Each cauldron’s status is color-coded as filling, emptying, or stable. Live Playback Animates cauldron fill levels over time with dynamic progress bars. Daily Summaries Aggregates daily statistics such as average, sum, min, and max essence levels. Courier Logs Summarizes witch ticket collections, total essence gathered, and average trip values. Discrepancy Detection Analyzes cauldron drain events versus ticket data to identify inconsistencies or unlogged activity.
App Navigation Tab Description Time Series Chronicle Essence levels over time Live Map View Interactive map of all cauldrons Live Playback Playback of cauldron fill and drain cycles Daily Essence Summary Aggregated statistics for each cauldron Witch Courier Logs Ticket and courier summaries Discrepancy Detection Detects fraudulent or missing data Ancient Records Raw data viewing and CSV export
Future Enhancements
- Machine learning model to forecast cauldron overflow
- Optimized routing to minimize required witches
- Real-time alert system for anomalies
- 3D visualization of potion flow and cauldron clusters