A comprehensive Python SDK for the RUCKUS One network management system, providing a Pythonic interface to manage enterprise wireless and wired infrastructure at scale. This SDK transforms complex REST API interactions into simple, intuitive Python methods while maintaining full API coverage.
The project includes an innovative CLI tool with an interactive "network switch-like" mode that mimics the familiar command-line experience of physical network devices, complete with tab completion, command history, and contextual help - bringing the best of both worlds together.
Key Innovation: Modular architecture with intelligent OAuth2 token management, automatic retry logic, and comprehensive error handling makes this SDK production-ready for enterprise deployments managing thousands of access points and switches.
Full implementation of RUCKUS One API endpoints for venues, APs, switches, WLANs, and VLANs
Network device-like CLI with tab completion, command history, and contextual help
Secure token management with automatic refresh and credential handling
Clean, intuitive API design following Python best practices and conventions
Efficient batch processing for managing large-scale network deployments
Comprehensive error handling with automatic retry logic and detailed logging
The SDK employs a modular, extensible architecture designed for reliability and ease of use:
The modular design allows for easy extension and customization, making it suitable for integration into larger automation frameworks or standalone network management applications.
$ r1cli --interactive
RUCKUS One CLI v0.1.0
Type 'help' for available commands
R1> show venues
╭──────────────────────────────────────╮
│ ID │ Name │ AP Count │
├──────────────────────────────────────┤
│ 001 │ Headquarters │ 245 │
│ 002 │ Branch Office │ 87 │
│ 003 │ Warehouse │ 156 │
╰──────────────────────────────────────╯
R1> config venue 001
R1(venue-001)> show aps
R1(venue-001)> reboot ap MAC:AD:DR:ES:S1
Rebooting AP... Success
This SDK bridges the gap between modern cloud-based network management and traditional CLI workflows, enabling network engineers to leverage familiar interfaces while accessing powerful API capabilities. Perfect for automation, monitoring, and large-scale network operations.
The R1 API SDK enables powerful network automation scenarios:
# Install from PyPI (when published)
pip install r1-api
# Or install from GitHub
pip install git+https://github.com/neuralconfig/r1-api.git
# Quick start
from r1_api import R1Client
client = R1Client(api_key="your-api-key")
venues = client.venues.list()