---
id: argon2-cffi
version: "25.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# argon2-cffi — Argon2 for Python

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install argon2-cffi
uv add argon2-cffi
poetry add argon2-cffi

## Description

# *argon2-cffi*: Argon2 for Python


[Argon2](https://github.com/p-h-c/phc-winner-argon2) won the [Password Hashing Competition](https://www.password-hashing.net/) and *argon2-cffi* is the simplest way to use it in Python:

```pycon
>>> from argon2 import PasswordHasher
>>> ph = PasswordHasher()
>>> hash = ph.hash("correct horse battery staple")
>>> hash  # doctest: +SKIP
'$argon2id$v=19$m=65536,t=3,p=4$MIIRqgvgQbgj220jfp0MPA$YfwJSVjtjSU0zzV/P3S9nnQ/USre2wvJMjfCIjrTQbg'
>>> ph.verify(hash, "correct horse battery staple")
True
>>> ph.check_needs_rehash(hash)
False
>>> ph.verify(hash, "Tr0ub4dor&3")
Traceback (most recent call last):
  ...
argon2.exceptions.VerifyMismatchError: The password does not match the supplied hash

```
<!-- end short -->

## Project Links

- [**PyPI**](https://pypi.org/project/argon2-cffi/)
- [**GitHub**](https://github.com/hynek/argon2-cffi)
- [**Documentation**](https://argon2-cffi.readthedocs.io/)
- [**Changelog**](https://github.com/hynek/argon2-cffi/blob/main/CHANGELOG.md)
- [**Funding**](https://hynek.me/say-thanks/)
- The low-level Argon2 CFFI bindings are maintained in the separate...

## AI interpretation — verify before relying

argon2-cffi provides Python bindings to the Argon2 password hashing algorithm, which won the Password Hashing Competition. It offers a simple API for hashing passwords, verifying them against stored hashes, and checking if rehashing is needed.

Verdict: argon2-cffi is a production-stable, actively maintained password hashing library backed by a competition-winning algorithm. MIT-licensed with low install friction, no known vulnerabilities, and broad Python version support make it a reliable choice for secure password storage in Python applications.

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