evilsocket /pwnagotchi
(⌐■_■) - Deep Reinforcement Learning instrumenting bettercap for WiFi pwning.
★ 9,265⑂ 1,233👁 259⑃ 579● 685▤ 21
+1
Daily
9,265
stars
1,233
forks
259
watchers
579
prs
685
issues
21
releases
README
Pwnagotchi is an A2C-based "AI" leveraging bettercap that learns from its surrounding WiFi environment to maximize the crackable WPA key material it captures (either passively, or by performing authentication and association attacks). This material is collected as PCAP files containing any form of handshake supported by hashcat, including PMKIDs, full and half WPA handshakes. !ui Instead of merely playing Super Mario or Atari games like most reinforcement learning-based "AI" (yawn), Pwnagotchi tunes its parameters over time to get better at pwning WiFi things to in the environments you expose it to. More specifically, Pwnagotchi is using an LSTM with MLP feature extractor as its policy network for the A2C agent. If you're unfamiliar with A2C, here is a very good introductory explanation (in comic form!) of the basic principles behind how Pwnagotchi learns. (You can read more about how Pwnagotchi learns in the Usage doc.) Keep in mind: Unlike the usual RL simulations, Pwnagotchi learns over time. Time for a Pwnagotchi is measured in epochs; a single epoch can last from a few seconds to minutes, depending on how many access points and client stations are visible. Do not expect your Pwnagotchi to perform amazingly well at the very beginning, as it will be exploring several combinations of key parameters to determine ideal adjustments for pwning the particular environment you are exposing it to during its beginning epochs ... but listen to your Pwnagotchi when it tells you it's boring! Bring it into novel WiFi environments with you and have it observe new networks and capture new handshakes—and you'll see. :) Multiple units within close physical proximity can "talk" to each other, advertising their presence to each other by broadcasting custom information elements using a parasite protocol I've built on top of the existing dot11 standard. Over time, two or more units trained together will learn to cooperate upon detecting each other's presence by dividing the available channels among them for optimal pwnage. Documentation https://www.pwnagotchi.ai Links | Official Links ---------|------- Website | pwnagotchi.ai Forum | community.pwnagotchi.ai Slack | pwnagotchi.slack.com Subreddit | r/pwnagotchi Twitter | @pwnagotchi License pwnagotchi is made with ♥ by @evilsocket and the amazing dev team. It is released under the GPL3 license.
Top issues
#1046Image won’t boot on Raspberry Pi Zero 2 W170 comments · 2021-11-02#267nexmon blindness bug (brcmf_cfg80211_nexmon_set_channel)96 comments · 2019-10-12#361pwnagotchi on x86/64 Linux40 comments · 2019-10-22#923[BUG] Please update APT signing key for http.re4son-kernel.com29 comments · 2020-09-26#508[BUG] bt-tether not connecting to an Android phone24 comments · 2019-11-03#411refactor web ui to be more customizable in terms of scaling and layout24 comments · 2019-10-26#934Config.toml22 comments · 2020-10-11#207Connect to home WiFi and get DHCP when specific BSSID is detected22 comments · 2019-10-07
Latest release
v1.5.5 v1.5.5 2021-04-18Changelog === New Features f164b8bb new: added new faces for uploading status ba13b125 added afrikaans lang 34c2c8a0 Add support for SSD1608 variant 250x122 pixel Inky pHATs 2db8f143 Display UPS-Lite charging status 840054f5 Display coordinates for dfrobotv2 929eac7b Updated gps.py to include positioning for the waveshare 2.7 inch screen, tested on my hardware: Raspberry Pi 3 /w waveshare 2.7 inch epaper hat, and USB GPS/GLONASS U-blox7 Fixes 1318275b fix: using better symbols for ups charging status 5c3b21f5 fix: recompiled localization files d6c7a73f fix: fixed w