Use when asked to manage UniFi network - list/restart/upgrade devices, block/unblock clients, manage WiFi networks, control PoE ports, manage traffic rules, create guest vouchers, or any UniFi control
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Agent-friendly UniFi Network tools powered by the
aiounifiRun all commands with:
uv run scripts/unifi.py <command> [args]Step 1: Ask user to create a dedicated local admin account
To manage your UniFi network, I need API access. Please create a dedicated local admin account:
- Open your UniFi controller (e.g., https://192.168.1.1)
- Go to Settings → System → Admins & Users
- Click Add Admin
- Enter a username (e.g.,
)agent-api- Enter an email and password
- Important: Disable "Remote Access" - local-only avoids MFA issues
- Set Role to Super Admin or Site Admin
- Click Add
Then provide:
- Controller IP (e.g.,
)192.168.1.1- Username
- Password
- Is it a UDM Pro/SE/Dream Machine? (yes/no)
Step 2: Save credentials to .env
UNIFI_HOST=https://192.168.1.1 UNIFI_USERNAME=agent-api UNIFI_PASSWORD=the_password UNIFI_SITE=default UNIFI_IS_UDM=true
Set
UNIFI_IS_UDM=falseunifi.py sites # List all sites unifi.py sysinfo # System information unifi.py health # Site health status (WAN, WLAN, LAN)
unifi.py devices # List all devices unifi.py device MAC # Device details unifi.py restart MAC # Restart device unifi.py restart MAC --hard # Hard restart (cycles PoE on switches) unifi.py upgrade MAC # Upgrade device firmware unifi.py locate MAC # Blink LED to locate unifi.py unlocate MAC # Stop LED blinking unifi.py led MAC on|off|default # Set LED status unifi.py led MAC on --color=#FF0000 --brightness=50 # With color/brightness
unifi.py ports # List all switch ports unifi.py port MAC PORT_IDX # Port details unifi.py port-enable MAC PORT_IDX # Enable switch port unifi.py port-disable MAC PORT_IDX # Disable switch port unifi.py poe MAC PORT_IDX MODE # Set PoE mode (auto|off|passthrough|24v) unifi.py power-cycle MAC PORT_IDX # Power cycle a PoE port
unifi.py outlets # List all outlets unifi.py outlet MAC IDX on|off # Control outlet relay unifi.py outlet-cycle MAC IDX on|off # Enable/disable auto-cycle on internet down
unifi.py clients # List active clients unifi.py clients-all # List all clients (including offline/known) unifi.py client MAC # Client details unifi.py block MAC # Block client from network unifi.py unblock MAC # Unblock client unifi.py reconnect MAC # Kick/reconnect client unifi.py forget MAC [MAC2...] # Forget client(s) permanently
unifi.py wlans # List wireless networks unifi.py wlan ID # WLAN details unifi.py wlan-enable ID # Enable WLAN unifi.py wlan-disable ID # Disable WLAN unifi.py wlan-password ID NEWPASS # Change WLAN password unifi.py wlan-qr ID # Generate WiFi QR code (PNG file) unifi.py wlan-qr ID -o myqr.png # Custom output filename
unifi.py port-forwards # List port forwarding rules unifi.py port-forward ID # Port forward details
unifi.py traffic-rules # List traffic rules unifi.py traffic-rule ID # Traffic rule details unifi.py traffic-rule-enable ID # Enable traffic rule unifi.py traffic-rule-disable ID # Disable traffic rule unifi.py traffic-rule-toggle ID on|off # Toggle traffic rule state
unifi.py traffic-routes # List traffic routes unifi.py traffic-route ID # Traffic route details unifi.py traffic-route-enable ID # Enable traffic route unifi.py traffic-route-disable ID # Disable traffic route
unifi.py firewall-policies # List firewall policies unifi.py firewall-policy ID # Firewall policy details unifi.py firewall-zones # List firewall zones unifi.py firewall-zone ID # Firewall zone details
unifi.py dpi-apps # List DPI restriction apps unifi.py dpi-app ID # DPI app details unifi.py dpi-app-enable ID # Enable DPI app restriction unifi.py dpi-app-disable ID # Disable DPI app restriction unifi.py dpi-groups # List DPI restriction groups unifi.py dpi-group ID # DPI group details
unifi.py vouchers # List vouchers unifi.py voucher-create --duration=60 --quota=1 --note="Guest" unifi.py voucher-create --duration=1440 --quota=5 --rate-up=5000 --rate-down=10000 unifi.py voucher-delete ID # Delete voucher
Voucher options:
--duration--quota--usage-quota--rate-up--rate-down--noteunifi.py events # Stream events in real-time (Ctrl+C to stop)
unifi.py raw GET /stat/health # Raw GET request unifi.py raw POST /cmd/devmgr '{"cmd":"restart","mac":"aa:bb:cc:dd:ee:ff"}' unifi.py raw PUT /rest/wlanconf/ID '{"enabled":false}'
Add
--jsonunifi.py devices --json # JSON output unifi.py clients --json
# Check network health uv run scripts/unifi.py healthList all connected clients
uv run scripts/unifi.py clients
Block a device
uv run scripts/unifi.py block "aa:bb:cc:dd:ee:ff"
Restart an access point
uv run scripts/unifi.py restart "11:22:33:44:55:66"
Disable guest WiFi
uv run scripts/unifi.py wlan-disable "5f8b3d2e1a4c7b9e0d6f8a2c"
Upgrade device firmware
uv run scripts/unifi.py upgrade "11:22:33:44:55:66"
Power cycle a PoE port (useful for rebooting PoE devices)
uv run scripts/unifi.py power-cycle "switch_mac" 5
Create a guest voucher (24 hours, single use)
uv run scripts/unifi.py voucher-create --duration=1440 --quota=1 --note="Guest access"
Generate WiFi QR code for easy connection
uv run scripts/unifi.py wlan-qr "wlan_id" -o guest_wifi.png
Control traffic rule
uv run scripts/unifi.py traffic-rule-disable "rule_id"
wlansIDdevicesMACclientsclients-allMACtraffic-rulesIDvouchersIDNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.