emerson@netdevops:~/proxmox-sdk$ ./describe.sh proxmox-sdk
proxmox-sdk
Schema-driven FastAPI SDK for the Proxmox API — generated, dual-mode, OpenAPI-first.
proxmox-sdk is a FastAPI package that mirrors the Proxmox VE API as a fully typed OpenAPI surface, with 675 endpoints generated from Proxmox VE 9.2.
It runs in two modes out of the box: a mock mode (default) with auto-generated CRUD data so you can develop without a real cluster, and a real mode that proxies validated requests to a live Proxmox host.
Beyond the server it ships a standalone async + sync Python SDK (ProxmoxSDK / SyncProxmoxSDK) with API-token and password/ticket authentication, a bring-your-own aiohttp session option, typed Ceph / PBS / PDM service clients, and an automated weekly schema-update workflow that detects upstream API drift and opens a PR.
›overview
emerson@netdevops:~/proxmox-sdk$ cat OVERVIEW.md
proxmox-sdk is a FastAPI package that mirrors the Proxmox VE API as a fully typed OpenAPI surface, with 675 endpoints generated from Proxmox VE 9.2.
It runs in two modes out of the box: a mock mode (default) with auto-generated CRUD data so you can develop without a real cluster, and a real mode that proxies validated requests to a live Proxmox host.
Beyond the server it ships a standalone async + sync Python SDK (ProxmoxSDK / SyncProxmoxSDK) with API-token and password/ticket authentication, a bring-your-own aiohttp session option, typed Ceph / PBS / PDM service clients, and an automated weekly schema-update workflow that detects upstream API drift and opens a PR.
›features
emerson@netdevops:~/proxmox-sdk$ ./features --list
- ├─675 pre-generated Proxmox VE 9.2 endpoints with full OpenAPI schema (9.1.11 retained)
- ├─Standalone async + sync Python SDK (ProxmoxSDK / SyncProxmoxSDK) — no server required
- ├─Dual mode: mock (default) for development, real for production
- ├─Reliable password/ticket auth (API-prefixed ticket URL + unquoted PVEAuthCookie) plus API-token auth with TOTP
- ├─Bring-your-own aiohttp session (session=) — reuse your connection pool, timeouts, tracing, or proxy
- ├─Typed Ceph / PBS / PDM service clients on top of the transport backends
- ├─Security hardening: SSRF-guarded download checksum discovery, credential redaction in logs, quoted SSH commands
- ├─Automated weekly schema sync — detects upstream API drift and opens a PR automatically
- ├─Multi-version CI matrix: latest, 9.2, and 9.1.11 each tested on every commit
- ├─Per-version mock state isolation (PROXMOX_MOCK_STATE_NAMESPACE) — safe for parallel runs
- ├─Per-service Docker tags: latest-pve, latest-pbs (Backup Server), latest-pdm (Datacenter Manager)
- ├─Real API proxy with request/response validation
- ├─Code generation: crawls the Proxmox API Viewer into OpenAPI
- ├─FastAPI-generated Swagger UI at /docs
- ├─Optional CLI / TUI extras with in-app view switching
›stack
emerson@netdevops:~/proxmox-sdk$ cat stack.txt
- › Python
- › FastAPI
- › OpenAPI 3.0
- › Pydantic
›install
emerson@netdevops:~/proxmox-sdk$ install
# Then visit /docs on the running app for live OpenAPI / Swagger. For Docker, pull emersonfelipesp/proxmox-sdk:latest-{pve,pbs,pdm} per service surface.
›repo
emerson@netdevops:~/proxmox-sdk$ repo:stats
- stars
- 6
- forks
- 2
- lang
- Python
- release
- v0.0.13
static · from public/github-data
›links
emerson@netdevops:~/proxmox-sdk$ links