Sovereign 8s.is mirror of 8b-is/WiFAKE
- Rust 92%
- Shell 4.6%
- HTML 2.2%
- TeX 0.7%
- CSS 0.3%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| docs | ||
| plans | ||
| WiFAKEaIntel | ||
| WiFAKEaRdino | ||
| WiFAKEaWeb | ||
| WiFAKEaYe | ||
| WiFAKEdRoid | ||
| WiFAKEeSp32 | ||
| WiFAKEiFone | ||
| WiFAKEiTm | ||
| WiFAKEnOde | ||
| WiFAKEoNe | ||
| WiFAKErFreq | ||
| WiFAKEsAfe | ||
| WiFAKEsDR | ||
| WiFAKEuNifi | ||
| WiFAKEwEb | ||
| .claude_consciousness.m8 | ||
| .gitignore | ||
| CLAUDE.md | ||
| README.md | ||
| TECHNICAL.md | ||
WiFAKE - Wireless Interceptor Framework for Anomaly Key Extraction
Distributed RF security monitoring with AI-powered threat analysis
WiFAKE is a family of Rust applications that work together to monitor RF environments, detect threats (drones, rogue devices, suspicious patterns), and alert users through an AI-powered analysis system.
Architecture
┌─────────────────────────────────────────────────────────────────────────┐
│ SENSOR LAYER │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ WiFAKEoNe │ │ WiFAKEiTm │ │ (future) │ │
│ │ │ │ │ │ │ │
│ │ • HackRF │ │ • SOCKS proxy│ │ • BLE scan │ │
│ │ • RTL-SDR │ │ • TLS intercept │ • WiFi monitor│ │
│ │ • Drone detect │ • App analysis│ │ • ESP32 mesh │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └───────────────────┼───────────────────┘ │
│ │ HTTP /api/sensors/report │
└─────────────────────────────┼───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ HUB LAYER │
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ WiFAKEwEb │ │
│ │ │ │
│ │ • Sensor registration & status Port 8424 │ │
│ │ • Alert aggregation & history │ │
│ │ • Family/Corp dashboard modes │ │
│ │ • Optional cloud sync (wifake.com) │ │
│ └──────────────────────────────┬───────────────────────────────────┘ │
│ │ │
└─────────────────────────────────┼───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ AI LAYER │
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ WiFAKEaYe │ │
│ │ "The AI Brain" │ │
│ │ │ │
│ │ • Local LLM (Ollama) - 95% of queries │ │
│ │ • Paid API (Claude) - 5% complex threats │ │
│ │ • Pattern recognition across sensors │ │
│ │ • Natural language threat reports │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Projects
| Project | Status | Description |
|---|---|---|
| WiFAKEoNe | Active | RF sensor node - HackRF/RTL-SDR drone detection |
| WiFAKEwEb | Active | Central hub - dashboard, sensor aggregation |
| WiFAKEiTm | Active | Man-in-the-Middle - SOCKS proxy for app analysis |
| WiFAKEaYe | Active | AI brain - LLM-powered threat analysis |
| WiFAKErFreq | Active | RF frequency analysis tools |
| WiFAKEiFone | Planned | iOS/mobile companion app |
| WiFAKEuNifi | Planned | UniFi integration add-on |
| WiFAKEeSp32 | Planned | ESP32 mesh sensor firmware |
| WiFAKEdRoid | Planned | Android companion app |
Quick Start
# Build all active projects
for d in WiFAKEoNe WiFAKEwEb WiFAKEiTm WiFAKEaYe; do
(cd $d && cargo build --release)
done
# Start the hub (central dashboard)
./WiFAKEwEb/target/release/wifake-web --mode family --port 8424
# Start a sensor node (on Raspberry Pi or other machine)
./WiFAKEoNe/target/release/wifake-one daemon --hub http://hub:8424 --hackrf
# Start the AI brain
./WiFAKEaYe/target/release/wifake-aye --budget 10.0
Naming Convention
Lowercase at position 2 and after "FAKE":
| Name | Meaning |
|---|---|
| WiFAKEoNe | RF reconnaissance - the "one" sensor platform |
| WiFAKEwEb | Web dashboard |
| WiFAKEiTm | Man in The Middle |
| WiFAKEaYe | The AI brain (Aye) |
| WiFAKEuNifi | Ubiquiti UniFi integration |
| WiFAKEiFone | iOS/iPhone app |
| WiFAKEeSp32 | ESP32 firmware |
Core Technology: Marine Algorithm
All WiFAKE projects use the marine-8b shared crate for signal analysis:
- O(1) jitter-based detection - No FFT required
- 4,457x faster than traditional approaches
- Real vs noise discrimination via phase jitter patterns
use marine_8b::{MarineDetector, MarineConfig, Salience};
let mut detector = MarineDetector::new(MarineConfig::fpv_5ghz());
let result = detector.process(sample);
// Drone signal: jitter < 0.15, authenticity > 60%
// Background noise: jitter > 0.30, authenticity < 20%
Service Discovery
All components advertise via Avahi/mDNS:
| Service | Type | Default Port |
|---|---|---|
| WiFAKEwEb | _wifake._tcp |
8424 |
| WiFAKEiTm | _wifakeitm._tcp |
1080 |
| WiFAKEaYe | _wifakeaye._tcp |
8428 |
| WiFAKEoNe | _wifakeone._tcp |
8424 |
Hardware Support
| Device | Use Case | Project |
|---|---|---|
| HackRF One | 5.8GHz drone detection, 2.4GHz WiFi | WiFAKEoNe |
| RTL-SDR | 433MHz ISM, TPMS tracking | WiFAKEoNe |
| Ubertooth One | Bluetooth monitoring | (planned) |
| AR9271 WiFi | Monitor mode packet capture | (planned) |
Transparency (Day One Principle)
Users can always:
- See what we CAN collect - Full technical disclosure
- See what we DO collect - Real-time dashboard visibility
- Delete their data - One-click removal, stored locally only
Documentation
- TECHNICAL.md - Deep dive into architecture and algorithms
- WiFAKEoNe/README.md - RF sensor documentation
- WiFAKEwEb/README.md - Hub documentation
License
MIT