PyPilotThe Python your project can actually run on

PyPilot intersects requires_python with the wheels each dependency publishes for your platform, sets up the environment on a version that works, and names the package that set the limit. It runs locally, with no AI service and no API keys.

Get started

What is PyPilot?

GitHub

🎯

Wheels, not just metadata

requires_python is often incomplete. PyPilot checks the wheel tags per platform too, so "mediapipe 0.10.14 stops at cp312" is caught before pip fails on 3.13.

How it works

🧭

Names the culprit

When no Python satisfies everything, doctor names both packages and their ranges. explain shows what blocks each Python version.

pypilot explain

⚡

Sets up the environment

uv by default (installs the Python it needs), plain venv + pip when you prefer, pixi in pixi projects. The Python it picks stays pinned.

pypilot setup

🟩

GPU builds that match the driver

Reads nvidia-smi, maps the driver to the newest CUDA it supports and pins the matching torch build (cu124, cu132, …). Apple Silicon gets MPS guidance.

GPU & CUDA

🧪

Import diagnostics

Squiggles on imports that are missing or will not run on this Python, quick fixes that install them, and checks for attributes removed from the installed release.

What it reports

📦

pixi when it helps

Detects pixi projects and works through pixi. When a dependency needs native libraries pip cannot install (GDAL, CUDA toolkit), it says so and migrates you.

pixi guide

See it work

A project that pins mediapipe==0.10.14 next to numpy. PyPilot reads PyPI and answers in a fraction of a second once metadata is cached:

~/src/demo

$ pypilot doctor
PyPilot doctor: C:\src\demo
  package manager : Auto

── Environment ──────────────────────────────────────────
  uv              : present (v0.13.5, on PATH)
  virtualenv      : none
  interpreters    : 3.15 (python3), 3.14 (C:\Python314\python.exe)
  data tables     : refreshed 3 hours ago (next in 6 days); 1 of 5 bundled

── Project ──────────────────────────────────────────────
  files           : requirements.txt
  dependencies    : mediapipe==0.10.14, numpy

── Compatibility ────────────────────────────────────────
  supported Python: 3.12
  recommended     : Python 3.12
    • mediapipe            3.9–3.12
    • numpy                3.12–3.15

── Findings ─────────────────────────────────────────────
  [WARN ] No environment set up yet
          Dependencies support Python 3.12. Recommended: 3.12 (upper bound set by mediapipe, which supports 3.9–3.12).

How it works

The editors and the pip package are thin wrappers. They find or download one native engine, and that engine does all the work: the same answers in Zed, VS Code and the terminal.

Data tables (CUDA, frameworks, import names, conda-forge) are compiled into the engine and refreshed from the repository every data_refresh_days (7 by default).

Install it where you work

Zed VS Code pip install pypilot-cli cargo install

PyPilotThe Python your project can actually run on

Wheels, not just metadata

Names the culprit

Sets up the environment

GPU builds that match the driver

Import diagnostics

pixi when it helps

See it work ​

How it works ​

Install it where you work ​

See it work

How it works

Install it where you work