> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sifr.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# SIFR-PYENV-0001: Python environment configuration is malformed.

> Python environment configuration is malformed.

`SIFR-PYENV-0001` belongs to the **Embedded CPython environment** diagnostic family. It means: python environment configuration is malformed.

## 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.

<Info>
  Use `sifr --explain SIFR-PYENV-0001` locally to see the renderer's exact message template and any machine-applicable suggestions for the compiler version you are running.
</Info>

## Details

| Field                  | Value                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------------- |
| Code                   | `SIFR-PYENV-0001`                                                                            |
| Family                 | `PYENV`                                                                                      |
| Severity               | Error                                                                                        |
| Stability              | stable                                                                                       |
| Owner                  | `sifr_package::python`                                                                       |
| Representative fixture | `crates/sifr_package/src/python/tests.rs::invalid_python_manifest_config_reports_pyenv_0001` |

See the [Error Codes index](/diagnostics/error-codes) for the complete catalog.