{"id":13586383,"url":"https://github.com/proxmoxer/proxmoxer","last_synced_at":"2026-02-19T07:31:25.509Z","repository":{"id":39161431,"uuid":"227804604","full_name":"proxmoxer/proxmoxer","owner":"proxmoxer","description":"python wrapper for Proxmox API v2 (https://pve.proxmox.com/pve-docs/api-viewer/index.html)","archived":false,"fork":false,"pushed_at":"2026-02-07T04:39:36.000Z","size":344,"stargazers_count":745,"open_issues_count":17,"forks_count":90,"subscribers_count":18,"default_branch":"develop","last_synced_at":"2026-02-13T03:53:40.244Z","etag":null,"topics":["api","infrastructure","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/proxmoxer.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-12-13T09:33:53.000Z","updated_at":"2026-02-12T18:37:49.000Z","dependencies_parsed_at":"2023-01-29T23:30:33.536Z","dependency_job_id":"78b54051-dcd8-405c-ab87-150bf31dd852","html_url":"https://github.com/proxmoxer/proxmoxer","commit_stats":{"total_commits":216,"total_committers":35,"mean_commits":6.171428571428572,"dds":0.6805555555555556,"last_synced_commit":"ef08243687dd0a2db1294070b9f8856ad77180fb"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/proxmoxer/proxmoxer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proxmoxer%2Fproxmoxer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proxmoxer%2Fproxmoxer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proxmoxer%2Fproxmoxer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proxmoxer%2Fproxmoxer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/proxmoxer","download_url":"https://codeload.github.com/proxmoxer/proxmoxer/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proxmoxer%2Fproxmoxer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29606846,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T06:47:36.664Z","status":"ssl_error","status_checked_at":"2026-02-19T06:45:47.551Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["api","infrastructure","python"],"created_at":"2024-08-01T15:05:31.896Z","updated_at":"2026-02-19T07:31:25.494Z","avatar_url":"https://github.com/proxmoxer.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"================================================\nProxmoxer: A Python wrapper for Proxmox REST API\n================================================\n\nmaster branch:  |master_build_status| |master_coverage_status| |pypi_version| |pypi_downloads|\n\ndevelop branch: |develop_build_status| |develop_coverage_status|\n\n\nProxmoxer is a python wrapper around the `Proxmox REST API v2 \u003chttps://pve.proxmox.com/pve-docs/api-viewer/index.html\u003e`_.\nIt currently supports the Proxmox services of Proxmox Virtual Environment (PVE), Proxmox Mail Gateway (PMG), and Proxmox Backup Server (PBS).\n\nIt was inspired by slumber, but it is dedicated only to Proxmox. It allows not only REST API use over HTTPS, but\nthe same api over ssh and pvesh utility.\n\nLike `Proxmoxia \u003chttps://github.com/baseblack/Proxmoxia\u003e`_, it dynamically creates attributes which responds to the\nattributes you've attempted to reach.\n\nFull Documentation is available at https://proxmoxer.github.io/docs/\n--------------------------------------------------------------------\n\nMigrating to version 2\n......................\n\nFull instructions for the minimal steps needed to update to version 2 can be found in `Migration Docs \u003chttps://proxmoxer.github.io/docs/latest/v1_migration/\u003e`_.\n\nInstallation\n............\n\n.. code-block:: bash\n\n    pip install proxmoxer\n\nTo use the 'https' backend, install requests\n\n.. code-block:: bash\n\n    pip install requests\n\nTo use the 'ssh_paramiko' backend, install paramiko\n\n.. code-block:: bash\n\n    pip install paramiko\n\nTo use the 'openssh' backend, install openssh_wrapper\n\n.. code-block:: bash\n\n    pip install openssh_wrapper\n\n\nShort usage information\n.......................\n\nThe first thing to do is import the proxmoxer library and create ProxmoxAPI instance.\n\n.. code-block:: python\n\n    from proxmoxer import ProxmoxAPI\n\n    proxmox = ProxmoxAPI(\n        \"proxmox_host\", user=\"admin@pam\", password=\"secret_word\", verify_ssl=False\n    )\n\nThis will connect by default to PVE through the 'https' backend.\n\n**Note: ensure you have the required libraries (listed above) for the connection method you are using**\n\nQueries are exposed via the access methods **get**, **post**, **put** and **delete**. For convenience two\nsynonyms are available: **create** for **post**, and **set** for **put**.\n\nUsing the paths from the `PVE API v2 \u003chttps://pve.proxmox.com/pve-docs/api-viewer/index.html\u003e`_, you can create\nAPI calls using the access methods above.\n\n.. code-block:: pycon\n\n    \u003e\u003e\u003e for node in proxmox.nodes.get():\n    ...     for vm in proxmox.nodes(node[\"node\"]).qemu.get():\n    ...         print(f\"{vm['vmid']}. {vm['name']} =\u003e {vm['status']}\")\n    ...\n\n    141. puppet-2.london.example.com =\u003e running\n    101. munki.london.example.com =\u003e running\n    102. redmine.london.example.com =\u003e running\n    140. dns-1.london.example.com =\u003e running\n    126. ns-3.london.example.com =\u003e running\n    113. rabbitmq.london.example.com =\u003e running\n\n\nSee Changelog in `CHANGELOG.md \u003chttps://github.com/proxmoxer/proxmoxer/blob/develop/CHANGELOG.md\u003e`_\n...................................................................................................\n\n.. |master_build_status| image:: https://github.com/proxmoxer/proxmoxer/actions/workflows/ci.yaml/badge.svg?branch=master\n    :target: https://github.com/proxmoxer/proxmoxer/actions\n\n.. |master_coverage_status| image:: https://img.shields.io/coveralls/github/proxmoxer/proxmoxer/master\n    :target: https://coveralls.io/github/proxmoxer/proxmoxer?branch=master\n\n.. |develop_build_status| image:: https://github.com/proxmoxer/proxmoxer/actions/workflows/ci.yaml/badge.svg?branch=develop\n    :target: https://github.com/proxmoxer/proxmoxer/actions\n\n.. |develop_coverage_status| image:: https://img.shields.io/coveralls/github/proxmoxer/proxmoxer/develop\n    :target: https://coveralls.io/github/proxmoxer/proxmoxer?branch=develop\n\n.. |pypi_version| image:: https://img.shields.io/pypi/v/proxmoxer.svg\n    :target: https://pypi.python.org/pypi/proxmoxer\n\n.. |pypi_downloads| image:: https://img.shields.io/pypi/dm/proxmoxer.svg\n    :target: https://pypi.python.org/pypi/proxmoxer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproxmoxer%2Fproxmoxer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fproxmoxer%2Fproxmoxer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproxmoxer%2Fproxmoxer/lists"}