CinderX

PyPI - Version

The CinderX logo, which is a lowercase "cinderx" with the dot in the i as a small flame, and a stylized orange x

CinderX is a Python extension that improves the performance of the Python runtime.

Status

CinderX is under active development. It is used in production at Meta for use-cases like the Instagram Django service. It is experimental for external users. New releases are published to PyPI on a weekly basis.

Features

  • JIT Compiler - Just-in-time compilation of Python bytecode to native machine code
  • Static Python - A stricter form/subset of Python, for type safety and optimization

The codebase includes other features as well, such as a parallel garbage collector and a lighter weight implementation of Python interpreter frames. However these features are not compatible with the stock CPython runtime yet.

Requirements

  • Python 3.14.3 or later
  • Linux (x86_64)
  • GCC 13+ or Clang 18+

The extension should build and import on macOS but most features will be disabled at runtime. Windows is not yet supported at all.

Installation

pip install cinderx

Using the JIT

The recommended way to start using the JIT is to do:

import cinderx.jit

cinderx.jit.auto()

This will configure the CinderX extension to automatically compile Python functions to machine code. It will track what functions are called frequently and compile the hottest ones automatically.

For more control over this process, you can pass the call count threshold to use for compilation instead of using auto():

import cinderx.jit

# Compile functions after they are called 10 times.
cinderx.jit.compile_after_n_calls(10)

If you want to compile individual functions, you can do so manually:

import cinderx.jit

def foo(): ...
def bar(): ...

# Compile `foo` immediately.
cinderx.jit.force_compile(foo)

# Compile `bar` the next time it is called.
cinderx.jit.lazy_compile(bar)

CinderX vs Cinder

Cinder was a fork of the CPython runtime developed at Meta. It included runtime optimizations (e.g. JIT) and was specifically targeted at the Instagram Django codebase. For Python 3.10, Meta decided to turn it into a Python extension to improve compatibility with newer Python versions. This extension is now known as CinderX ("the X" is for "extension").

For Python versions 3.10 through 3.12, CinderX still depends on patches to Meta's fork of the Python runtime. Python 3.14 is the first version of stock CPython that CinderX supports.

License

CinderX is MIT licensed, see the LICENSE file.

Terms of Use

https://opensource.fb.com/legal/terms

Privacy Policy

https://opensource.fb.com/legal/privacy

Copyright © 2025 Meta Platforms, Inc.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2026.8.3.0)

Owner

PyPI data
Data sourced directly from PyPI's database.

2 maintainers

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

License expression

MIT
View SPDX License List

Requires

Python <3.16, >=3.14.0

Tags

performance jit compiler optimization cinder

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cinderx-2026.3.30.0.tar.gz (1.6 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

cinderx-2026.3.30.0-cp314-cp314-musllinux_1_2_x86_64.whl (29.9 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

cinderx-2026.3.30.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (29.4 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

File details

Details for the file cinderx-2026.3.30.0.tar.gz.

File metadata

  • Download URL: cinderx-2026.3.30.0.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cinderx-2026.3.30.0.tar.gz
Algorithm Hash digest
SHA256 05121ece820d86335c9cc97e83ad0d3c5ca6f9c8cad6f851e25ad2be9328bf3e
MD5 b78f3e93824d34d2ee0fcad3154bc3d0
BLAKE2b-256 8f7fee08bad651fc19fcc30a1e2ccfcf39251a85f685321c399ddf5cd04cf6df

See more details on using hashes here.

Provenance

The following attestation bundles were made for cinderx-2026.3.30.0.tar.gz:

Publisher: publish.yml on facebookincubator/cinderx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cinderx-2026.3.30.0-cp314-cp314-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for cinderx-2026.3.30.0-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 a2db1fcb1d611e60104ef2fe7bba9a44e72c214a35c95c67b38859b684c1ebd6
MD5 ae129cba7ae40d25989f8cccede10479
BLAKE2b-256 bff5a2e34a16105c823c1a8ccf048cd970abe9e20423cd4275cd3cc908cb27d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for cinderx-2026.3.30.0-cp314-cp314-musllinux_1_2_x86_64.whl:

Publisher: publish.yml on facebookincubator/cinderx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cinderx-2026.3.30.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for cinderx-2026.3.30.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 e798b3a84cc6a4c5cd42a211cc0c21a09e60c4af121e5ffe5ad040314f46ffc3
MD5 0f13b8f3a3c6b1328a306abf88e7d1c4
BLAKE2b-256 497dbc2b942d956743049be159731eebd061185957fc7c0c50baca5864816142

See more details on using hashes here.

Provenance

The following attestation bundles were made for cinderx-2026.3.30.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on facebookincubator/cinderx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page