catalystwan
Cisco Catalyst WAN SDK for Python
Decision gist · record as of 2026-08-14
Yes, if you are developing against Cisco Catalyst SD-WAN Manager and can tolerate early-beta stability. The low install friction, active maintenance, and lack of known vulnerabilities make it a reasonable choice for non-production automation. Do not use in production until the package exits beta. Verify the license terms before integrating into commercial software.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires network connectivity to a Cisco Catalyst SD-WAN Manager instance; credentials and manager URL must be provided.
- Low install friction with a pure-wheel distribution.
- The package is in active development with a recent release (14 days old) and an active repository, though it is explicitly marked as early beta and not recommended for production use.
License · maintenance · safety
(unclear) — License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before use, particularly if integrating into proprietary or commercially distributed software.
last release 2026-07-31 (14 days) · last repo commit 2026-08-10 · 11 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 213,905 downloads/mo, #9,425 on PyPI
Alternatives
Verify before relying
from catalystwan.session import create_manager_session
with create_manager_session(url="example.com", username="admin", password="password123") as session:
devices = session.api.devices.get()
print(devices)- Stability and backward-compatibility guarantees during beta phase remain unclear.
- Production readiness timeline and support escalation process for early beta issues.
- Thread-safety guarantees beyond the documented recommendation to use one session per thread.
What it is and what it does
Catalystwan is a Python SDK for automating Cisco Catalyst SD-WAN Manager operations via REST API. It abstracts authentication, session lifecycle, and concurrent request handling, supporting multiple deployment modes (provider, tenant, provider-as-tenant) and API Gateway authentication. The package wraps the official SD-WAN Manager API and extends requests.Session, so all standard HTTP capabilities are available alongside SDK-specific methods for device management, alarms, software upgrades, and diagnostics.
The SDK is designed for parallel request execution with built-in request limiting (default 50 concurrent requests) to prevent server overload. It provides context manager support for automatic resource cleanup and includes threading examples for multi-threaded workloads. However, the package is in early beta and explicitly not recommended for production environments; it is intended for development and testing against SD-WAN Manager instances.
Use it for
- Automate device inventory queries and status checks across SD-WAN fabric from a Python application.
- Orchestrate software upgrades and configuration changes on multiple controllers and vSmarts in parallel.
- Generate and retrieve diagnostic files (admin tech) from SD-WAN devices for troubleshooting.
- Build multi-tenant management workflows where a provider manages multiple tenant SD-WAN domains.
- Integrate SD-WAN alarms and monitoring data into external dashboards or ticketing systems.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are developing against Cisco Catalyst SD-WAN Manager and can tolerate early-beta stability.
The low install friction, active maintenance, and lack of known vulnerabilities make it a reasonable choice for non-production automation. Do not use in production until the package exits beta. Verify the license terms before integrating into commercial software.
Install
catalystwan on PyPI
Before you install
Low install friction with a pure-wheel distribution. The package is in active development with a recent release (14 days old) and an active repository, though it is explicitly marked as early beta and not recommended for production use.
Requires network connectivity to a Cisco Catalyst SD-WAN Manager instance; credentials and manager URL must be provided.
License in practice
License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before use, particularly if integrating into proprietary or commercially distributed software.
Quickstart
from catalystwan.session import create_manager_session
with create_manager_session(url="example.com", username="admin", password="password123") as session:
devices = session.api.devices.get()
print(devices)Verify before relying
- Stability and backward-compatibility guarantees during beta phase remain unclear.
- Production readiness timeline and support escalation process for early beta issues.
- Thread-safety guarantees beyond the documented recommendation to use one session per thread.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release <4.0.0,>=3.8.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 12 packagesrequestspython-dateutilattrsciscoconfparsetenacityJinja2flake8-quotesclintrequests-toolbeltpackagingpydantictyping-extensions |
| Maintenance | Actively maintained 14 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 213,905 / month, #9,425 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: catalystwan-0.41.6-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “cisco sd-wan api python”
- catalystwanProvides a Python SDK for programmatic interaction with Cisco…
- scc-firewall-manager-sdkProvides a Python SDK for interacting with Cisco Security Cloud…
- ciscoisesdkA Python SDK for interacting with Cisco Identity Services Engine…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also ciscoisesdk · pyatlan · scc-firewall-manager-sdk · napalm · rest.connector · tplink-omada-client · meraki · python-keycloak · office365-rest-python-client · scaleway-core