Quick Start Example

from pyhwloc import from_this_system

# Create and load system topology
with from_this_system() as topo:
    # Get basic system information
    n_cores = topo.n_cores()
    n_numa = topo.n_numa_nodes()

    print(f"System has {n_cores} CPU cores")
    print(f"System has {n_numa} NUMA nodes")

    # Get the current CPU binding
    cpuset = topo.get_cpubind()
    print(f"Current CPU binding: {cpuset}")

Install

pip install pyhwloc

Supported platforms:

  • Linux distributions, tested with latest Ubuntu LTS.

  • Latest Windows.

The binaries on PyPI have optional support for CUDA 13 plugins.

Project links

Data verified by PyPI on May 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Jiaming from gravatar.com Jiaming

Credits

Data verified by PyPI on May 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI. Confirms that the provided email matches a verified, public email address on a PyPI user account associated with the project.

Author/Maintainer: Jiaming Yuan

GitHub Statistics

Data verified by PyPI on May 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD-3-Clause

Requires

Python >=3.12

Classifiers

Report project as malware

Metadata

Project links

Data verified by PyPI on May 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Jiaming from gravatar.com Jiaming

Credits

Data verified by PyPI on May 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI. Confirms that the provided email matches a verified, public email address on a PyPI user account associated with the project.

Author/Maintainer: Jiaming Yuan

GitHub Statistics

Data verified by PyPI on May 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD-3-Clause

Requires

Python >=3.12

Classifiers

Report project as malware

Release files for pyhwloc 3.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyhwloc 3.0.1
File Size Uploaded
pyhwloc-3.0.1.tar.gz 95.0 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for pyhwloc 3.0.1
File Interpreter ABI Platform
pyhwloc-3.0.1-py3-none-win_amd64.whl 674.3 kB Python 3 none Windows x86-64 Details
pyhwloc-3.0.1-py3-none-manylinux_2_34_x86_64.whl 2.5 MB Python 3 none Linux glibc 2.34+ x86-64 Details
pyhwloc-3.0.1-py3-none-manylinux_2_34_aarch64.whl 2.4 MB Python 3 none Linux glibc 2.34+ ARM64 Details

Total release size: 5.7 MB

Release files / pyhwloc-3.0.1.tar.gz

Download URL pyhwloc-3.0.1.tar.gz
Size 95.0 kB
Tags Source
SHA-256 checksum
How to use checksums 		7a068f72d6ed15708bd507f062017c6f3da7d778d748958e3702a0759070cca8
BLAKE2b-256 checksum
How to use checksums 		9667257e9f4744a21c9fe7136cc639aafce618bd675fa69377c7ba0e8c60e1b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/open-mpi/pyhwloc
Publishing commit
github.com/open-mpi/pyhwloc/tree/5ee05da30f8ba362e40cadea5619b9915670674c
Workflow
Publishing configuration
github.com/open-mpi/pyhwloc/blob/5ee05da30f8ba362e40cadea5619b9915670674c/.github/workflows/pypi.yml
Publishing logs
github.com/open-mpi/pyhwloc/actions/runs/25715801754/attempts/1
Artifact
Subject
pyhwloc-3.0.1.tar.gz
SHA-256 checksum
7a068f72d6ed15708bd507f062017c6f3da7d778d748958e3702a0759070cca8 Verifying attestations

Release files / pyhwloc-3.0.1-py3-none-win_amd64.whl

Download URL pyhwloc-3.0.1-py3-none-win_amd64.whl
Size 674.3 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums 		07ef6ffcde04c77c35c4184f6ef050864376b44f0a47af31e12817dc0b849673
BLAKE2b-256 checksum
How to use checksums 		10f5ec8ec9e59c163912d7741d277eee7f4f31b82aa59574fe1611ce45def010
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/open-mpi/pyhwloc
Publishing commit
github.com/open-mpi/pyhwloc/tree/5ee05da30f8ba362e40cadea5619b9915670674c
Workflow
Publishing configuration
github.com/open-mpi/pyhwloc/blob/5ee05da30f8ba362e40cadea5619b9915670674c/.github/workflows/pypi.yml
Publishing logs
github.com/open-mpi/pyhwloc/actions/runs/25715801754/attempts/1
Artifact
Subject
pyhwloc-3.0.1-py3-none-win_amd64.whl
SHA-256 checksum
07ef6ffcde04c77c35c4184f6ef050864376b44f0a47af31e12817dc0b849673 Verifying attestations

Release files / pyhwloc-3.0.1-py3-none-manylinux_2_34_x86_64.whl

Download URL pyhwloc-3.0.1-py3-none-manylinux_2_34_x86_64.whl
Size 2.5 MB
Tags Linux glibc 2.34+ x86-64 Python 3
SHA-256 checksum
How to use checksums 		527d297708238072453de68e73084545bf98ac0c2f07ce25176ceaf761fa19e6
BLAKE2b-256 checksum
How to use checksums 		236bb6967a4d58f99e9ff2464753ab218df407e841534615624847130c40445e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/open-mpi/pyhwloc
Publishing commit
github.com/open-mpi/pyhwloc/tree/5ee05da30f8ba362e40cadea5619b9915670674c
Workflow
Publishing configuration
github.com/open-mpi/pyhwloc/blob/5ee05da30f8ba362e40cadea5619b9915670674c/.github/workflows/pypi.yml
Publishing logs
github.com/open-mpi/pyhwloc/actions/runs/25715801754/attempts/1
Artifact
Subject
pyhwloc-3.0.1-py3-none-manylinux_2_34_x86_64.whl
SHA-256 checksum
527d297708238072453de68e73084545bf98ac0c2f07ce25176ceaf761fa19e6 Verifying attestations

Release files / pyhwloc-3.0.1-py3-none-manylinux_2_34_aarch64.whl

Download URL pyhwloc-3.0.1-py3-none-manylinux_2_34_aarch64.whl
Size 2.4 MB
Tags Linux glibc 2.34+ ARM64 Python 3
SHA-256 checksum
How to use checksums 		4d27294f2b9a6930b46802b047a429786664ee13963557890afa6c9bce6deaff
BLAKE2b-256 checksum
How to use checksums 		6bf60ac13a2c439ee79f63eb373bf3d6c81e549165523dc75a7168e180d79fff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 12, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/open-mpi/pyhwloc
Publishing commit
github.com/open-mpi/pyhwloc/tree/5ee05da30f8ba362e40cadea5619b9915670674c
Workflow
Publishing configuration
github.com/open-mpi/pyhwloc/blob/5ee05da30f8ba362e40cadea5619b9915670674c/.github/workflows/pypi.yml
Publishing logs
github.com/open-mpi/pyhwloc/actions/runs/25715801754/attempts/1
Artifact
Subject
pyhwloc-3.0.1-py3-none-manylinux_2_34_aarch64.whl
SHA-256 checksum
4d27294f2b9a6930b46802b047a429786664ee13963557890afa6c9bce6deaff Verifying attestations

Release history Release notifications | RSS feed

This release

3.0.1 This release

4 release files

3.0.0

4 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page