# jayofelony/pwnagotchi

(⌐■_■) - Raspberry Pi instrumenting Bettercap for Wi-Fi pwning.

Repository: https://github.com/jayofelony/pwnagotchi
Canonical: https://ross.abutalabs.com/products/jayofelony-pwnagotchi
Homepage: http://pwnagotchi.org
Language: Python
License: NOASSERTION
License Family: other
Topics: gadget, hacking-tool, pwn, pwnagotchi, python, wifi, penetration-testing, rpi3, rpi4, rpi5, rpizero, tech-tools, technology, raspberrypi
Last push: 2026-08-23T19:28:38+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 69
- inputs: {"age_days": 972, "days_push": 10, "days_rel": 15, "gap_med": 5.0, "n_releases_24m": 15}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2886, forks 323 (observed 2026-08-28T04:07:28.169550+00:00)

## What it is
Pwnagotchi is a Raspberry Pi-based Wi-Fi penetration-testing gadget that leverages Bettercap to passively sniff or actively attack nearby Wi-Fi networks, capturing WPA handshake and PMKID material for cracking with hashcat. This jayofelony fork is the actively maintained community image supporting Pi Zero W through Pi 5, with a plugin system, e-ink face UI, and unit-to-unit mesh communication.

## Use cases
- capture WPA handshakes and PMKIDs for hashcat cracking
- build a portable Wi-Fi auditing gadget on a Raspberry Pi
- learn Wi-Fi security and penetration testing hands-on
- run a community-maintained pwnagotchi image on Pi Zero 2 W or Pi 5
- extend a pwnagotchi with third-party plugins and custom displays
- let multiple pwnagotchi units discover each other via the parasite protocol

## When to choose
- you want an actively maintained pwnagotchi fork with support for newer Raspberry Pi hardware
- you want to capture crackable WPA key material on portable hardware
- you want a customizable, plugin-extensible Wi-Fi hacking device with an e-ink UI

## When to avoid
- you need a general-purpose Wi-Fi auditing toolkit on a laptop rather than dedicated Pi hardware
- you want the original AI-based learning mode, which was removed for stability and battery reasons
- you need legal, authorized enterprise wireless assessments with reporting features

## Facets
- artifact type: application
- maturity: active
- function: penetration-testing, security, monitoring, plugin-system
- domain: security, penetration-testing, hardware, networking
- platform: embedded, python, iot
- tags: wifi-hacking, raspberry-pi, bettercap, wpa-handshake-capture, hashcat, e-ink-display, pmkid, hacking-gadget, community-fork, linux

## Member repositories
- jayofelony/pwnagotchi (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:28.169550+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:35:23.146922+00:00, confidence not recorded.
  - readme: https://github.com/jayofelony/pwnagotchi (fetched 2026-08-28T04:07:28.169550+00:00, sha 754978528e80)
  - homepage: http://pwnagotchi.org (fetched 2026-08-29T09:50:46.785107+00:00, sha 60872cc13751)
  - site_page: https://pwnagotchi.org/getting-started/index.html (fetched 2026-08-29T09:50:46.794345+00:00, sha 17b59c133f10)
  - site_page: https://pwnagotchi.org/getting-started/suggested-working-hardware/index.html (fetched 2026-08-29T09:50:46.796131+00:00, sha bc0c451f6ca7)
  - site_page: https://pwnagotchi.org/getting-started/software/index.html (fetched 2026-08-29T09:50:46.798029+00:00, sha fd8542715a9a)
  - site_page: https://pwnagotchi.org/getting-started/installation/index.html (fetched 2026-08-29T09:50:46.799658+00:00, sha e50920908b39)
  - site_page: https://pwnagotchi.org/getting-started/configuration/index.html (fetched 2026-08-29T09:50:46.801181+00:00, sha 09163ff87f25)
  - site_page: https://pwnagotchi.org/getting-started/first-run-windows/index.html (fetched 2026-08-29T09:50:46.802713+00:00, sha d2aafc77b22f)
  - site_page: https://pwnagotchi.org/getting-started/first-run-mac/index.html (fetched 2026-08-29T09:50:46.804232+00:00, sha f790d4695c49)
  - site_page: https://pwnagotchi.org/getting-started/first-run-linux/index.html (fetched 2026-08-29T09:50:46.805945+00:00, sha bb32c95a32ec)
- Data as of 2026-08-30T08:39:29.467469+00:00.