python-codicefiscale

python-codicefiscale is a library for encode/decode Italian fiscal code - codifica/decodifica del Codice Fiscale.

Codice Fiscale

Features

NEW Auto-updated data (once a week) directly from ANPR data-source.
NEW Command Line Interface available.
Transliteration for name/surname
Multiple birthdate formats (date/string) (you can see all the supported string formats here)
Automatic birthplace city/foreign-country code detection from name
Omocodia support

Installation

pip install python-codicefiscale

Usage

Python

Import

from codicefiscale import codicefiscale

Encode

codicefiscale.encode(
    lastname="Caccamo",
    firstname="Fabio",
    gender="M",
    birthdate="03/04/1985",
    birthplace="Torino",
)

# "CCCFBA85D03L219P"

Decode

codicefiscale.decode("CCCFBA85D03L219P")

# {
#     "code": "CCCFBA85D03L219P",
#     "gender": "M",
#     "birthdate": datetime.datetime(1985, 4, 3, 0, 0),
#     "birthplace": {
#         "name": "TORINO"
#         "province": "TO",
#         "code": "L219",
#     },
#     "omocodes": [
#         "CCCFBA85D03L219P",
#         "CCCFBA85D03L21VE",
#         "CCCFBA85D03L2MVP",
#         "CCCFBA85D03LNMVE",
#         "CCCFBA85D0PLNMVA",
#         "CCCFBA85DLPLNMVL",
#         "CCCFBA8RDLPLNMVX",
#         "CCCFBAURDLPLNMVU",
#     ],
#     "raw": {
#         "code": "CCCFBA85D03L219P",
#         "lastname": "CCC",
#         "firstname": "FBA",
#         "birthdate": "85D03",
#         "birthdate_year": "85"
#         "birthdate_month": "D",
#         "birthdate_day": "03",
#         "birthplace": "L219",
#         "cin": "P",
#     },
# }

Check

codicefiscale.is_valid("CCCFBA85D03L219P")

# True

codicefiscale.is_omocode("CCCFBA85D03L219P")

# False

Command Line

[!CAUTION] If sensitive data is written to a log entry it could be exposed to an attacker who gains access to the logs.

This library can be used also as a CLI tool, for more info run:

python -m codicefiscale --help

Encode (CLI)

python -m codicefiscale encode --firstname Fabio --lastname Caccamo --gender M --birthdate 03/04/1985 --birthplace Torino

Decode (CLI)

python -m codicefiscale decode CCCFBA85D03L219P

Testing

# clone repository
git clone https://github.com/fabiocaccamo/python-codicefiscale.git && cd python-codicefiscale

# create virtualenv and activate it
python -m venv venv && . venv/bin/activate

# upgrade pip
python -m pip install --upgrade pip

# install requirements
pip install -r requirements.txt -r requirements-test.txt

# install pre-commit to run formatters and linters
pre-commit install --install-hooks

# run tests using tox
tox

# or run tests using pytest
pytest

License

Released under MIT License.

Supporting

:star: Star this project on GitHub
:octocat: Follow me on GitHub
:blue_heart: Follow me on Bluesky
:moneybag: Sponsor me on Github

Metadata

Release files for python-codicefiscale 0.11.4

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

Source distribution (sdist)

Source distribution for python-codicefiscale 0.11.4
File	Size	Uploaded
python_codicefiscale-0.11.4.tar.gz	421.3 kB	Apr 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-codicefiscale 0.11.4
File	Interpreter	ABI	Platform	Reset
python_codicefiscale-0.11.4-py3-none-any.whl 432.2 kB Apr 12, 2026	Python 3	none	any	Details

Total release size: 853.5 kB

Release files / python_codicefiscale-0.11.4.tar.gz

Download URL	python_codicefiscale-0.11.4.tar.gz
Size	421.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`2c1e2921e4fb46a5f8ff8f1079f0f7d95df32b63f1e31b27d8d9d92b2552e789`
BLAKE2b-256 checksum How to use checksums	`14438c59ad3c04335e58562c59bd95a70a1bf234fb2ab036c21849843a7713a3`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fabiocaccamo/python-codicefiscale
Publishing commit: github.com/fabiocaccamo/python-codicefiscale/tree/e160f37a981007993c71a895110c516e7ccbfd8e

Workflow

Publishing configuration: github.com/fabiocaccamo/python-codicefiscale/blob/e160f37a981007993c71a895110c516e7ccbfd8e/.github/workflows/create-release.yml
Publishing logs: github.com/fabiocaccamo/python-codicefiscale/actions/runs/24315664143/attempts/1

Artifact

Subject: python_codicefiscale-0.11.4.tar.gz
SHA-256 checksum: 2c1e2921e4fb46a5f8ff8f1079f0f7d95df32b63f1e31b27d8d9d92b2552e789 Verifying attestations

Release files / python_codicefiscale-0.11.4-py3-none-any.whl

Download URL	python_codicefiscale-0.11.4-py3-none-any.whl
Size	432.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3007644b27db3ee02a3c7d20be96ad2b40a344f26e63ffdb0ef3bbd0cf23a6fb`
BLAKE2b-256 checksum How to use checksums	`4b01287f68a3a3acd23e80a8e9b6dd0262b408468006477cb6abf07bc62d22ac`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fabiocaccamo/python-codicefiscale
Publishing commit: github.com/fabiocaccamo/python-codicefiscale/tree/e160f37a981007993c71a895110c516e7ccbfd8e

Workflow

Publishing configuration: github.com/fabiocaccamo/python-codicefiscale/blob/e160f37a981007993c71a895110c516e7ccbfd8e/.github/workflows/create-release.yml
Publishing logs: github.com/fabiocaccamo/python-codicefiscale/actions/runs/24315664143/attempts/1

Artifact

Subject: python_codicefiscale-0.11.4-py3-none-any.whl
SHA-256 checksum: 3007644b27db3ee02a3c7d20be96ad2b40a344f26e63ffdb0ef3bbd0cf23a6fb Verifying attestations