Project-Ouroboros - Project Ouroboros is a modular, dual-use cybersecu

项目说明

Project Ouroboros – Unified Wireless Security Research

> ⚠️ Disclaimer: This project is for educational, research, and ethical security purposes only. Misuse of hardware or software is strictly the responsibility of the user.

---

🌐 O

Project Ouroboros is a modular, dual-use cybersecurity platform encompassing multiple ESP32-based hardware and firmware modules for wireless defense, monitoring, and controlled research/offense experiments.

It is structured as a parent ecosystem:

* Blue Pill (Passi) : Consumer-friendly, multi-layer defense shield (Wi-Fi, BLE, Sub-GHz) with anomaly detection and automated mitigation.
* OuroMini: Rapid-prototype dual-use demo board (15-day expo build) showcasing real-time wireless telemetry, , and ghost traces.

The Ouroboros philosophy: eternal cycle of attack & defense — integrating , telemetry, and interacti in a single hardware/firmware ecosystem.

---

🔹 Core Objectives

* Defense: Protect home, personal, and IoT networks from Wi-Fi, BLE, Sub-GHz attacks.
* Research: Safe experimentation of offensi for learning and controlled testing.
* : Real-time telemetry, ghost traces, waterfall spectrums, and dashboards for expos or lab demos.
* Rapid Deployment: Prebuilt .bin firmware, modular hardware, and standardized flashing for fast prototyping.
* Extensibility: Supports TinyML, AI-assisted anomaly detection, and additional RF front-ends.

---

🏗️ Sub-Projects & Modules

Blue Pill – Defensi

Purpose: Consumer-ready Wi-Fi/BLE/Sub-GHz network protection.

Features:

* Real-time intrusion detection (deauth, rogue AP, spoofing).
* TinyML anomaly detection for smarter threat recognition.
* Acti: automated mitigation, reconnection, and hardened configs.
* Spectrum : waterfall graphs on OLED/TFT.
* Logging & optional dashboard telemetry.

Hardware & Firmware:

* ESP32-U/WROOM-32E, OLED/TFT, optional Sub-GHz & BLE modules.
* Firmware modularity allows independent updates for each protocol.

Resources:

* Blue Pill Docs

---

OuroMini – 15-Day Expo Prototype

Purpose: Rapid 15-day dual-use prototype for expos & demos.

Highlights:

* Real-time scanning: Wi-Fi, BLE, Sub-GHz.
* OLED : RSSI bars, waterfall graphs, ghost-traces.
* Dual-mode toggle: Defensive .
* SD card logging and optional dashboard telemetry.

Hardware: ESP32 MCU, OLED, minimal peripherals, external antennas.

Firmware: Modular scanning, menu-driven UI, safe demo constraints.

Docs:

Ouromini Abstract

OuroMini Expo Documentation

Architecture & Firmware Details

---

Modules

| Module | Purpose | Notes |
| ---------------- | ------------------------------ | ------------------------- |
| CC1101 / Sub-GHz | RF monitoring & replay | 315/433/868/915 MHz bands |
| NRF24L01 | Mesh/network testing | 2.4 GHz experimentation |
| PN532 / RFID-NFC | Tag scanning & emulation | Access control research |
| IR Transceiver | Consumer device capture/replay | NEC, RC5, Samsung, etc. |
| FM / Audio | Frequency scanning & demo | only |

---

🛠️ Hardware Requirements

Core MCU:

* ESP32-U / S3 for more RAM and peripherals.

Optional:

* OLED / TFT display ( & menus)
* External antennas for Wi-Fi/BLE/Sub-GHz
* Shields/modules for ad research

---

💻 Software Stack

Firmware Base:

* ESP-IDF
* Arduino-ESP32

Key Libraries:

* WiFi, BLE, RadioLib (Sub-GHz)
* TensorFlow Lite Micro (TinyML)
* ArduinoJson, LittleFS, ESPAsyncWebServer
* U8g2, TFT_eSPI, LVGL for

Optional Tools:

* HackRF / RTL-SDR for ad RF
* Edge Impulse / TinyML SDKs

---

📂 Directory Structure

---

📚 Learning & Contribution Roadmap

1. Learn ESP32 basics → Wi-Fi, BLE, FreeRTOS.
2. Implement Wi-Fi monitoring & defense → deauth, rogue AP detection.
3. Explore BLE & Sub-GHz experimentation → spoofing, jamming, replay attacks.
4. Add & dashboards → OLED/TFT/ESPAsyncWebServer.
5. Integrate TinyML / AI models → anomaly detection for defense.
6. Combine offensive & defensi → multitasking with FreeRTOS.
7. Extend Shields & peripherals → ad RF and sensor experiments.

---

🔗 References

* Espressif ESP32 Documentation
* OWASP Wi-Fi Security Guide
* NIST Wi-Fi Security Guidelines (SP 800-153)
* HackRF Spectrum Analyzer
* TensorFlow Lite Micro
* Edge Impulse

---

📜 License

Project Ouroboros © 2025
Licensed under GNU GPL-3.0 – use, modify, and redistribute under GPL terms. See LICENSE.

Credits & Attribution

OuroMini's firmware is derived from ESP32 Marauder by Just Call Me Koko, originally released under the MIT License (Copyright © 2020 Just Call Me Koko). Marauder was itself inspired by Spacehuhn's esp8266_deauther.

What OuroMini changes: ported to ESP32-WROOM-32 as a headless target, removed the display, touch and on-device menu subsystems, and rebuilt the interaction layer around a web dashboard and serial/UART interface. See docs/ARCHITECTURE.md for the full breakdown.

OuroMini as a whole is licensed under GNU GPL-3.0. The original MIT-licensed Marauder components remain under their original terms, and the upstream notice is retained in LICENSE-MIT.

---

✅ This README serves as the central hub for the entire Ouroboros ecosystem: Blue Pill, Red Pill, OuroMini, Shields, and optional modules, pro newcomers and contributors with the complete project o, architecture, and references.

项目信息

开发语言：Makefile

Star 数：2

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Project Ouroboros is a modular, dual-use cybersecurity platform encompassing multiple ESP32-based hardware and firmware modules for wireless defense, monitoring, and controlled research/offense experiments.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。