SIFR-PYENV-0010: Free-threaded CPython is not supported for embedded interop. - Sifr

SIFR-PYENV-0010 belongs to the Embedded CPython environment diagnostic family. It means: free-threaded CPython is not supported for embedded interop.

Why It Happens

The selected Python environment is missing, malformed, ambiguous, or fails probe/ABI checks. Configure exactly one root-application uv environment and ensure the interpreter, site-packages, and declared imports are available.

Use sifr --explain SIFR-PYENV-0010 locally to see the renderer’s exact message template and any machine-applicable suggestions for the compiler version you are running.

Details

Field	Value
Code	`SIFR-PYENV-0010`
Family	`PYENV`
Severity	Error
Stability	stable
Owner	`sifr_package::python`
Representative fixture	`crates/sifr_package/src/python/probe_validation_tests.rs::probe_rejects_free_threaded_cpython_with_pyenv_0010`

See the Error Codes index for the complete catalog.