RIFT
RIFT: Real-time Intelligent Fleet Technology
Related Projects
📖 Overview
View Overview
RIFT is the centralized command-and-control backbone of the Cursed Entertainment robotics ecosystem. Built with Python and Flask, it serves as a high-speed telemetry hub that bridges the gap between various hardware platforms—like WHIP, NORA, and KIDA—and the user interface. By utilizing a unified communication protocol, RIFT allows for seamless fleet management and synchronized multi-agent operations. Core Features - [x] Fleet Dashboard: Real-time monitoring and control of multiple robots from a single interface. - [x] Protocol Bridging: Seamlessly translates commands between PC, Android, and diverse microcontroller platforms. - [x] Autoconnect Hub: Logic-based routing for local and remote instances (localhost:5000 through 5006). - [x] Telemetry Visualization: Live data streaming from IMU (MPU6050) and Ultrasonic sensors across the fleet. #### ESP32/Wi-Fi Network Communications: This system uses [NORA-Robot-v00](https://github.com/CursedPrograms/NORA-Robot-v00) as a central hub, while human devices like phones and PCs act as control interfaces. [Friday](https://github.com/CursedPrograms/ComCentre) can also assist with verbal communication between users and robots. #### Supported Development & Runtime Environments - Microcontrollers: ESP32, Arduino IDE - PC & Mobile Apps: Android Studio, MinGW (Windows/Linux) - Operating Systems: Raspberry Pi OS, Ubuntu, Windows, AndroidRIFT: :5000
DREAM: :5001
NORA: :5002
KIDA-00: :5003
KIDA-01: :5004
WHIP: :5005
MILA: :5010
How to Run:
View How to Run
### Environment Setup/Install Dependencies ```bash sudo snap install android-studio --classic python3 -m venv venv source venv/bin/activate pip install --upgrade pip pip install -r requirements.txt ``` ### Run app.py for the Flask fleet dashboard Runs the fleet registry, mDNS discovery (including browsing for ComCentre), and the RIFT/NORA integration threads (fleet-authority heartbeat, internet share) all in one Python process — no compiling required. ```bash python app.py ``` This is a full alternative to the native fleet server below: both speak the same `/robots` + `/register` protocol on port 5000, so run one or the other, not both, on a given machine. ## ⚙️ Compile (native alternative) ### 🐧 Linux (`PC App/App`) `network-discovery.cpp` is RIFT's native fleet-registry server: it publishes itself on the LAN via mDNS/Avahi (`_rift._tcp`), browses for other RIFT instances, and serves the `/robots` + `/register` endpoints that `registration.cpp`, `PC App/PyGame/registration.py`, and `Fleet/register.py` all talk to. `registration.cpp` is the subnet-scanning client that queries `/robots`. ```bash ./build.sh ``` This installs the required apt dev packages (`libcurl4-openssl-dev`, `libavahi-client-dev`, `nlohmann-json3-dev`, `libcpp-httplib-dev`) if missing — you'll be asked for your sudo password — then builds both binaries into `PC App/App/bin/`. To start the fleet server once built: ```bash ./run_server.sh ``` Or build manually with the Makefile: ```bash cd "PC App/App" make ``` ### 🪟 Windows (MinGW) ```bash g++ registration.cpp -o registration.exe -lcurl ```
© Cursed Entertainment 2026
