⚠️ BETA — Active development. Hardware compatibility not guaranteed. Do not purchase hardware based solely on this project.
Open Source · Raspberry Pi 5 · Field Unit

NekoPi
Field Unit

A portable network diagnostic toolkit for field engineers. Plug into any client network — get instant visibility across WiFi, wired, and security layers.

25+
Modules
2.5G
Test Interface
WiFi 7
HAT Support
100%
On-device
Raspberry Pi 5 Ubuntu 24.04 FastAPI · Python 3.12 nmap · iPerf3 · LLDP Kismet IDS Gemini AI · Ollama Local No Subscription MIT License

Capabilities
Everything a field engineer needs,
on one device
📡
WiFi Analysis Live
AP scan, RSSI/SNR, channel utilization, security modes, band steering detection.
🔧
WiFi Troubleshooter Live
Guided diagnosis of WiFi issues with AI-assisted recommendations.
🛜
Roaming Analyzer Live
Passive 802.11r/k/v capture, FT timing, roam event log and AP transition data.
📻
Profiler Live
WLAN client capability profiling — 802.11 features, spatial streams, supported rates.
🚨
Kismet IDS Live
Wireless intrusion detection — rogue AP, evil twin, deauth flood, anomalous probes.
📦
OTA Capture Live
Over-the-air packet capture with monitor mode, downloadable PCAP files.
🔌
Wired / LAN Live
Full wired diagnostics panel with sub-modules for every layer.
🖧
LLDP/CDP Live
Neighbor discovery — Cisco, Juniper, Aruba. Shows device, port, VLAN, capabilities.
iPerf3 Live
TCP/UDP throughput test, bidirectional, multi-stream. Client and server mode.
🏷️
VLAN Probe Live
Detect accessible VLANs in the network. Full 802.1Q range scan.
🔐
802.1X Detection Live
EAP/RADIUS detection, PEAP/TLS/FAST identification, VLAN assignment check.
📞
VoIP / QoS Live
G.711/G.722 simulation, MOS scoring, jitter/loss, DSCP marking verification.
🌊
DHCP Stress Live
Pool exhaustion test — simulate N clients, measure response time and capacity.
🔍
DNS Benchmark Live
Compare multiple DNS servers by latency. Identifies fastest resolver for the site.
💡
Port Blinker Live
Blink switch port LEDs to identify physical cabling. No labeling needed.
🔒
Security Audit Live
nmap CVE scan, open ports, Telnet/FTP/SNMP exposure, default credentials. Score 0–100.
🧰
Rescue Toolkit Live
TFTP server, captive portal test, network tools for field recovery scenarios.
🌐
NetPush Live
Network connectivity push tests and WAN diagnostics.
📉
Path Analyzer Live
PingPlotter-style traceroute with per-hop RTT timeline and loss detection.
📊
Sensor Mode Live
Continuous passive monitoring with pktvisor, traffic stats, Grafana integration.
Quick Check Live
One-tap ping, DNS, gateway, captive portal detection and public IP lookup.
🖥️
Console Pusher Live
USB-to-serial console to Cisco, Mikrotik, and other devices — in-browser terminal.
📋
Reports Live
Export findings to PDF. Executive summary, findings by severity, recommendations.
🌐
Connection Live
WAN info, NAT toggle, interface status, QR code for quick access.
📶
IoT & Sensors Soon
LoRa / Zigbee device visibility. In development for v1.1.
🧠 AI-Assisted Analysis

Before any analysis, NekoPi automatically anonymizes all network data — IPs, hostnames, MAC addresses, and identifiers are replaced with generic labels (Host-A, Host-B…). Only the anonymized data is sent to the AI engine. The original mapping stays on the device.

☁️ Gemini (Cloud)
Google Gemini via API key. Anonymized data is sent to Google's servers for analysis. Best for field use — no additional infrastructure required. Configure your API key in Settings.
🖥️ Ollama (LAN Server)
Connects to an Ollama instance running on a PC or server in the same network. The RPi5 is not powerful enough to run LLMs locally — Ollama runs on your laptop or a dedicated server. Supports llama3, mistral, phi3 and others. No data leaves your network.

Bill of Materials
Purpose-built hardware
Raspberry Pi 5
4GB / 8GB RAM
Main compute · Ubuntu 24.04 LTS
MPW2.5G-NA-WiFi7
RTL8125B + MT7925
2.5GbE TEST interface · WiFi 7 HAT
CF-953AX
MT7921AU · USB
Passive capture · monitor mode
Storage
32GB+ microSD
OS + captures + AI models
InterfaceRoleDefault IPNotes
eth0TEST — client networkDHCPRTL8125B 2.5GbE HAT
eth1MGMT — laptop uplink192.168.99.1/24RPi5 native GbE · dnsmasq DHCP
wlan0WiFi analysisMT7925 HAT · WiFi 7
wlan1Passive captureUSB dongle · monitor mode

Try it — no hardware needed

The interactive demo runs entirely in your browser with simulated data. Explore every module and see what NekoPi looks like in the field.

▶ Launch Demo
// Simulated data only · No RPi5 required · All modules visible