Pwnagotchi is an open-source, Raspberry Pi-oriented Wi‑Fi security project built around bettercap. Its animated “pet” is a device persona and display—not a chatbot—and the original project’s AI is a reinforcement-learning agent that adapts its capture settings while observing a Wi‑Fi environment. It records WPA-related key material in packet-capture files; it does not itself crack a password. Use it only on networks you own or are explicitly authorized to assess.
What is a Pwnagotchi?
Pwnagotchi is a small computer running project software that uses bettercap to observe nearby Wi‑Fi activity and save supported WPA-related material. Its distinctive pet-like interface gives status and personality to a security tool. The name does not refer to one fixed implementation: the original project and later community forks can differ, including in whether they retain the original AI modes.
| # | Preview | Product | Price | |
|---|---|---|---|---|
| 1 |
|
Freenove Raspberry Pi Pico 2 W Board Pre-Soldered Header, Dual Arm Cortex-M33 and Dual Hazard3... | $18.95 | Buy on Amazon |
| 2 |
|
SANOOV Raspberry Pi Zero 2W Kit | $111.99 | Buy on Amazon |
The original project describes its purpose as maximizing the crackable WPA key material it captures, either passively or through authentication and association techniques. “Capture” is the important word: a saved packet capture is material for later authorized analysis, not a recovered password.
What are a handshake and PMKID?
When a client connects to a wireless access point, the WPA four-way handshake is part of the process used to generate encryption keys. Pwnagotchi can save packet-capture files containing supported handshake material, including full or partial handshakes, and PMKIDs. Some captured forms can be analyzed with tools such as hashcat, but the capture alone does not establish that the network password has been found—or that it can be recovered.
Free tools Windows power users keep installed
One-click scans. No signup required.
#1 Best Overall
- Latest Version: Higher core clock speed, double memory, more powerful Arm cores, optional RISC-V cores (compared to the 1 series) (This W version has onboard wireless LAN and Bluetooth)
- Switchable Cores: Allows users to choose between dual industry-standard Arm Cortex-M33 cores and dual open-hardware Hazard3 cores
- Compatibility: Delivers a significant performance boost, while retaining software- and hardware-compatible with the 1 series
- Detailed Tutorial: Provides step-by-step guide with MicroPython, C and Processing (Java) Code (The download link can be found on the product box) (No paper tutorial)
- Example Projects: Each project has schematics, wiring diagrams, complete code and detailed explanations (Need extra items)
How does the original Pwnagotchi AI work?
The original project describes its “AI” as an Advantage Actor-Critic (A2C) reinforcement-learning agent. Its policy network uses an LSTM with an MLP feature extractor. Rather than chatting or answering questions, the agent adjusts capture parameters over training epochs as it observes its Wi‑Fi environment and receives rewards according to its objective.
The original documentation distinguishes two modes:
- AI mode: adapts capture settings based on the agent’s training and reward function.
- AUTO mode: uses a basic algorithm rather than the AI agent’s adaptive parameter selection.
These labels describe the original project’s behavior; they should not be assumed to apply to every fork. For example, the jayofelony community fork says its version removes the AI components, with its maintainer attributing that decision to concerns that AI destabilized Wi‑Fi firmware. That is the maintainer’s explanation, not proof that AI universally causes firmware instability.
What does a Pwnagotchi build involve?
The original installation guide uses the Raspberry Pi Zero W as its “vanilla” reference body. Its documented baseline is:
Recommended Free Tools
Rank #2
- Powerful Performance: Equipped with a quad-core 64-bit ARM Cortex-A53 processor, the Raspberry Pi Zero 2 W delivers a significant performance boost compared to its predecessor. And built-in Wi-Fi and Bluetooth support enable easy wireless communication and Internet access for your projects, five Times Faster.
- SANOOV Basic Starter Kit for Pi Zero 2 W Include: 1. Raspberry Pi Zero 2 W Board 2.Mini HDMI to Standard HDMI adapter 3.Micro-USB to Standard USB OTG Adapter 4.Aluminum Heatsink 5.40 Pin Header.NOTICE: The kit does NOT include , supply power, case, SD card, keyboard, mouse or monitor.
- SANOOV for Raspberry Pi Zero 2 W features: 1GHz quad-core, 64-bit ARM Cortex-A53 CPU VideoCore IV GPU 512MB LPDDR2 DRAM 802.11b/g/n wireless LAN Bluetooth 4.2 / Bluetooth Low Energy (BLE) MicroSD card slot Mini HDMI and USB 2.0 OTG ports Micro USB power HAT-compatible 40-pin header Composite video and reset pins via solder test points CSI camera connector.
- Video Output & Efficient Cooling: Supports 1080p30 video output via the mini HDMI port, making it ideal for multimedia applications and streaming.The aluminum heatsink helps dissipate heat, ensuring stable performance even under heavy workloads.
- Compact Size: The tiny size of the Raspberry Pi Zero 2 W makes it perfect for space-constrained projects and embedded applications.Ideal for a variety of uses, including IoT projects, home automation, media centers, educational tools, and more.
| Item | Role | Requirement in the original guide |
|---|---|---|
| Raspberry Pi Zero W | Reference computer for the build | Baseline body |
| microSD card | Stores the operating system and project image | Required |
| Data-capable micro-USB cable | Connects the device during setup | Required; a charging-only cable is not sufficient |
| Portable power bank | Provides portable power | Required in the guide’s list |
| Supported display | Shows the pet interface | Optional |
| Hardware clock | Provides a dedicated timekeeping component | Optional |
This is the original guide’s baseline, not a guarantee that every board revision, display, Wi‑Fi adapter, or fork image will work. Before buying parts, check the installation and compatibility instructions for the particular project branch and image you intend to use. Board architecture, monitor-mode support, and whether the branch retains AI modes are especially relevant.
Typical image-based setup
- Choose the project branch and image for your hardware, then download that image from its project source.
- Verify the downloaded image’s SHA-256 checksum against the value published for that image.
- Write the image to the microSD card with an image writer such as balenaEtcher.
- Follow that branch’s instructions for first boot, connection, and any optional display or clock.
The original project also documents a manual GNU/Linux installation. That route may require adapting interface names and monitor-mode startup to the selected computer and Wi‑Fi card; use the instructions for the branch and hardware rather than assuming a single universal setup.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.What can it do—and what requires permission?
The original documentation describes both passive capture and active techniques, including deauthentication and association attacks. Passive observation and active disruption are not interchangeable: active methods can interfere with clients’ connections. Operate only on networks you own or have explicit permission to test, and check the rules that apply where you are operating. The project documentation does not settle the law for every jurisdiction.
Which Pwnagotchi version should you choose?
Start by identifying the exact repository, release or image, and hardware combination—not just the name “Pwnagotchi.” The original project describes an AI-enabled design, while at least one surfaced community fork says it removed that AI. The available project descriptions do not establish a complete current comparison of release status, maintenance, or compatibility across branches.
Quick Recap
- Confirm the image supports your board and processor architecture.
- Check whether the Wi‑Fi interface and its driver support the required monitor-mode behavior.
- Separate essential components from optional extras such as a display and hardware clock.
- Verify whether the branch includes AI mode, AUTO mode, or neither, and follow that branch’s own setup notes.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
