medvedodesa

WiFi captive portal setup for Raspberry Pi — button-triggered or auto AP mode with web UI for network configuration

10
1
100% credibility
Found Apr 05, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A Python library that enables Raspberry Pi devices to set up WiFi connections through a temporary hotspot and web interface triggered automatically or by a button press.

How It Works

1
🛠️ Find easy WiFi helper

You discover a simple tool to help your Raspberry Pi connect to home WiFi without complicated steps.

2
🔌 Add a button

Wire a push button to your Pi's pin – it takes seconds and lets you trigger setup anytime.

3
🔋 Power on your Pi

Turn on your gadget, and it creates its own temporary hotspot if no WiFi is saved yet.

4
📱 Join the hotspot

Grab your phone, connect to the Pi's network that pops up, just like any other WiFi.

5
🌐 See nearby networks

Open your browser – it automatically shows a page with a list of WiFi options around you.

6
Pick your WiFi

Tap your home network, enter the password, and watch it connect smoothly.

Ready to go!

Your Pi joins your WiFi forever, runs your project happily, and the button lets you switch networks easily later.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is pi-wifi-setup?

This Python library turns your Raspberry Pi into a self-configuring WiFi device via a captive portal hotspot. On first boot without saved credentials or a long button press on GPIO 17, it spins up an AP (SSID like "MyDevice"), redirects phones to a Flask web UI at 192.168.4.1 listing nearby networks via scanner, lets users pick one and enter a password, then saves it persistently with NetworkManager. No monitor needed—perfect for headless pi setup wifi on Pi Zero W, Zero 2 W, 3, 4, or 5 running OS Lite.

Why is it gaining traction?

Unlike manual nmcli hacks or SSH-only raspberry pi setup wifi via ssh, it offers a phone-friendly wifi captive portal with auto-login probes for Android/iOS, signal bars on scanned networks, and programmatic hooks to pause/resume your app during setup. Button-triggered reconfiguration beats recompiling images, and it auto-detects Pi Zero quirks for reliable AP mode. Devs dig the pip-install simplicity and API for blocking first-boot connects or background wifi manager.

Who should use this?

IoT builders deploying headless Raspberry Pi sensors, kiosks, or vending machines needing setup wifi raspberry pi lite without dongles. Makers doing pi zero w wifi setup or setup wifi on raspberry pi 4 in the field. Skip if you're on Ethernet or prefer wpa_supplicant YAML edits.

Verdict

Grab it for quick captive portal prototypes—solid docs, MIT license, and clean API make it dev-friendly despite 10 stars and 1.0% credibility signaling early beta status. Test on your hardware; it's not battle-tested for production fleets yet.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.