Skip to content

Concepts

The ideas behind Pyfaro, in the order you are likely to need them.

  • How it works

    Pyfaro is an integration layer: uv, Ruff, ty and pytest do the work.

  • Projects

    How Pyfaro finds the project a command applies to, and --project.

  • Environments and tools

    Where the environment lives and how tools are found.

  • Configuration

    The optional [tool.pyfaro] table and its schema version.

  • Exit codes

    What 0, 1, 2, 130 and forwarded codes mean.

  • Security and privacy

    No telemetry, which tools touch the network, what Pyfaro runs and what you trust when you install it.

  • Platform support

    What works on Linux, macOS and Windows.

Next steps