{"id":37882898,"url":"https://github.com/cisco-en-programmability/catalystwan-sdk-next-python","last_synced_at":"2026-01-20T16:44:44.001Z","repository":{"id":276981993,"uuid":"897218688","full_name":"cisco-en-programmability/catalystwan-sdk-next-python","owner":"cisco-en-programmability","description":"Catalystwan SDK 2","archived":false,"fork":false,"pushed_at":"2025-11-24T08:31:06.000Z","size":4204,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-04T15:53:18.911Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cisco-en-programmability.github.io/catalystwan-sdk-next-python/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cisco-en-programmability.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-02T08:49:58.000Z","updated_at":"2025-08-11T13:17:20.000Z","dependencies_parsed_at":"2025-07-18T09:23:36.633Z","dependency_job_id":null,"html_url":"https://github.com/cisco-en-programmability/catalystwan-sdk-next-python","commit_stats":null,"previous_names":["cisco-en-programmability/catalystwan-sdk-next-python"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cisco-en-programmability/catalystwan-sdk-next-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisco-en-programmability%2Fcatalystwan-sdk-next-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisco-en-programmability%2Fcatalystwan-sdk-next-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisco-en-programmability%2Fcatalystwan-sdk-next-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisco-en-programmability%2Fcatalystwan-sdk-next-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cisco-en-programmability","download_url":"https://codeload.github.com/cisco-en-programmability/catalystwan-sdk-next-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisco-en-programmability%2Fcatalystwan-sdk-next-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T16:49:48.352Z","updated_at":"2026-01-16T16:49:49.179Z","avatar_url":"https://github.com/cisco-en-programmability.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Cisco Catalyst WAN SDK 2.0\n==========================\n\nWelcome to the official documentation for the Cisco Catalyst WAN SDK, a package designed for creating simple and parallel automatic requests via the official SD-WAN Manager API.\n\nOverview\n--------\n\nCisco Catalyst WAN SDK serves as a multiple session handler (provider, provider as a tenant, tenant) and is environment-independent. You just need a connection to any SD-WAN Manager.\n\nSupported Catalystwan WAN Server Versions\n-----------------------------------------\n\n- 20.15\n- 20.16\n\nCisco Catalyst WAN SDK – Early Access Release\n---------------------------------------------\n\nWe are excited to introduce the Cisco Catalyst WAN SDK in its early access release phase,\nmarking an important step in enabling developers to harness the full potential of Cisco's\nnetworking solutions. This release provides a unique opportunity to explore and experiment\nwith the SDK's capabilities as we continue to refine and enhance its features.\n\nAs this version is part of an early development stage, it is provided \"as is\" and is still\nundergoing active testing and iteration. While we are committed to supporting your experience\non a best-effort basis, we recommend exercising caution and conducting thorough testing before\ndeploying it in a production environment.\n\nYour feedback during this phase is invaluable in shaping the SDK to meet the needs of our developer\ncommunity. Thank you for partnering with us on this journey to innovate and advance networking automation.\n\nSupported Python Versions\n-------------------------\n\nPython \u003e= 3.8\n\n\u003e If you don't have a specific version, you can just use [Pyenv](https://github.com/pyenv/pyenv) to manage Python versions.\n\n\nInstallation\n------------\n\nTo install the SDK, run the following command:\n\n```bash\npip install catalystwan==2.0.0a0\n```\n\nTo manually install the necessary Python packages in editable mode, you can use the `pip install -e` command.\n\n```bash\npip install -e ./packages/catalystwan-types \\\n            -e ./packages/catalystwan-core \\\n            -e ./versions/catalystwan-v20_15 \\\n            -e ./versions/catalystwan-v20_16\n```\n\n\nGetting Started\n---------------\n\nTo execute SDK APIs, you need to create a `ApiClient`. Use the `create_client()` method to configure a session, perform authentication, and obtain a `ApiClient` instance in an operational state.\n\n### Example Usage\n\nHere's a quick example of how to use the SDK:\n\n```python\nfrom catalystwan.core import create_client\n\nurl = \"example.com\"\nusername = \"admin\"\npassword = \"password123\"\n\nwith create_client(url=url, username=username, password=password) as client:\n    result = client.health.devices.get_devices_health()\n    print(result)\n```\n\nIf you need to preform more complex operations that require models, they can utilize an alias: `m`.\n```python\n\nwith create_client(...) as client:\n    result = client.admin.aaa.update_aaa_config(\n        client.admin.aaa.m.Aaa(\n            accounting: True,\n            admin_auth_order: False,\n            audit_disable: False,\n            auth_fallback: False,\n            auth_order: [\"local\"]\n        )\n    )\n    print(result)\n```\n\nUsing an alias allows for easier access and management of models, simplifying workflows and improving efficiency. This approach helps streamline operations without requiring direct integration with underlying models, making them more user-friendly and scalable.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcisco-en-programmability%2Fcatalystwan-sdk-next-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcisco-en-programmability%2Fcatalystwan-sdk-next-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcisco-en-programmability%2Fcatalystwan-sdk-next-python/lists"}