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%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-01-24 02:29:08 -05:00
docs docs 2026-01-24 02:29:08 -05:00
plans Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEaIntel Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
WiFAKEaRdino Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEaWeb Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEaYe Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
WiFAKEdRoid Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEeSp32 Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
WiFAKEiFone Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
WiFAKEiTm Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
WiFAKEnOde Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEoNe init 2026-01-24 02:02:15 -05:00
WiFAKErFreq init 2026-01-24 02:02:15 -05:00
WiFAKEsAfe Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEsDR Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEuNifi Add initial README files for various WiFAKE components 2026-01-24 02:11:27 -05:00
WiFAKEwEb Add initial README files and configuration for WiFAKE components 2026-01-24 02:10:38 -05:00
.claude_consciousness.m8 docs 2026-01-24 02:29:08 -05:00
.gitignore docs 2026-01-24 02:29:08 -05:00
CLAUDE.md init 2026-01-24 02:02:15 -05:00
README.md init 2026-01-24 02:02:15 -05:00
TECHNICAL.md init 2026-01-24 02:02:15 -05:00

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

License

MIT