---
id: poseidon-py
version: "0.2.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# poseidon-py — Python implementation of Poseidon hash

License: unclear · Maintenance: active · Downloads: 108.7K/mo

## What it is and what it does

Poseidon-py provides a Python wrapper around a C implementation of the Poseidon hash function with the Hades permutation, preconfigured with parameters used in Starknet. It is a cryptographic hash function designed for zero-knowledge proof systems and blockchain applications. The package compiles to native code for performance-critical hashing operations and is distributed as precompiled wheels for most common platforms (Linux, macOS, Windows across multiple architectures). With zero runtime dependencies, it integrates directly into Python applications that need Starknet-compatible hashing.

The package is actively maintained and supports modern Python versions (3.10 and later), with recent updates adding support for Python 3.13 and 3.14. Installation is straightforward on supported platforms via prebuilt wheels, though the compiled nature means some architectures may require local compilation. The Starknet parameter set is baked into the library, making it suitable for applications that specifically need Starknet-compatible hashing without configuration overhead.

Use it for:

- Compute Poseidon hashes for Starknet smart contracts or off-chain verification
- Implement zero-knowledge proof systems that require Starknet-compatible hash functions
- Validate or generate Merkle trees using Poseidon hashing in blockchain applications
- Integrate Starknet-compatible cryptographic operations into Python applications

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Poseidon hash implementation in Python with a C-based Hades permutation, configured for Starknet parameters.

Yes, if you need Starknet-compatible Poseidon hashing. The package is actively maintained, has no known vulnerabilities, zero runtime dependencies, and offers precompiled wheels for broad platform coverage. The main caveat is that the license status is unclear—verify the licensing terms before use in proprietary contexts. Install friction is moderate due to compilation requirements on unsupported architectures, but negligible on common platforms.

## Install

pip install poseidon-py
uv add poseidon-py
poetry add poseidon-py

## Installing poseidon-py

Before you install: Medium install friction due to compiled wheels across many platforms (x86_64, aarch64, armv7l, ppc64le, s390x, riscv64, Windows, macOS). Actively maintained with recent release (2026-03-26) and current repository activity.

License in practice: License status is unclear—no SPDX identifier or raw license text provided. Verify licensing before use in proprietary or commercial contexts.

Quickstart:

pip install poseidon-py

import poseidon_py
# Hash computation using Starknet-configured parameters

Requires Python 3.10 or later; precompiled wheels available for common platforms but may require compilation on unsupported architectures.

Verify before relying:

- Exact API surface and available functions beyond the hash computation itself
- Whether parameters in poseidon_params.txt are user-configurable or Starknet-only
- Performance characteristics compared to other Poseidon implementations
- Formal license under which the package is distributed

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 108.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

poseidon hash python, starknet hashing, cryptographic hash function, poseidon permutation, zero-knowledge proof hashing, starknet cryptography, starknet, zero-knowledge-proofs, cryptographic-hashing

[View on SkillFed](https://skillfed.io/packages/poseidon-py) · [View on PyPI](https://pypi.org/project/poseidon-py/)