pwnagotchi/README.md

2.3 KiB

Pwnagotchi

Pwnagotchi is an "AI" that learns from the WiFi environment and instruments bettercap in order to maximize the WPA key material (any form of handshake that is crackable) captured. Specifically, it's using an LSTM with MLP feature extractor as its policy network for the A2C agent. Here is a very good intro on the subject.

Instead of playing Super Mario or Atari games, pwnagotchi will tune over time its own parameters, effectively learning to get better at pwning WiFi things. Keep in mind: unlike the usual RL simulations, pwnagotchi learns over time, do not expect it to perform amazingly well at the beginning, as it'll be exploring several combinations of parameters ... but listen to it when it's bored, bring it with you and have it observe new networks and capture new handshakes and you'll see :)

If you are a boring person, you can disable the AI and have the algorithm run just with the preconfigured default parameters.

Several states and states transitions are configurable and represented on the display as different expressions and sentences.

The software requires bettercap compiled from master.

Documentation

THIS IS STILL ALPHA STAGE SOFTWARE, IF YOU DECIDE TO TRY TO USE IT, YOU ARE ON YOUR OWN, NO SUPPORT WILL BE PROVIDED, NEITHER FOR INSTALLATION OR FOR BUGS

Hardware

  • Raspberry Pi Zero W
  • Waveshare eInk Display (optional if you connect to usb0 and point your browser to the web ui, see config.yml)
  • A decent power bank (with 1500 mAh you get ~2 hours with AI on)

Software

  • Raspbian + nexmon patches for monitor mode, or any Linux with a monitor mode enabled interface (if you tune config.yml).

License

pwnagotchi is made with ♥ by @evilsocket and it's released under the GPL3 license.