How pypilot-dev/pypilot-vscode works
PyPilot is a VS Code extension that coordinates a native PyPilot engine per Python workspace. The main workflow is activation and helper resolution, project/server setup, user-triggered diagnosis or environment changes, and presentation of status or a doctor report. The README also documents engine capabilities such as Python-version and CUDA matching, import diagnostics, and pixi support. Several of those engine internals are not in this repository; they are represented as documented capabilities, not inspected implementation. Links reflect sampled source references or README statements.
Main entry points: extension.ts Extension Activation · commands.ts Command Handlers · downloader.ts Helper Resolution · venv.ts Interpreter Selection
Components 21
Activation and Engine
- Extension Activation
src/extension.ts - Helper Resolution
src/downloader.ts - Download Transport
src/net.ts - Helper Installer
src/helperInstall.ts - Engine Version Checks
src/engine.ts
Workspace Integration
- Workspace Language Clients
src/clients.ts - Command Handlers
src/commands.ts - Workspace Tasks
src/tasks.ts - Status Bar
src/statusBar.ts
Project Diagnosis
- Doctor and Fixes
- Python Version Resolution
- CUDA and Driver Matching
- Import Diagnostics
- Report Coordination
src/report.ts - Interactive Report Panel
src/webview/reportPanel.ts
Environment Management
- Project Detection
src/project.ts - Interpreter Selection
src/venv.ts
Other components
- Python Developer
- VS Code
- Native PyPilot Engine
- Python Extension API
Connections 31
- Python Developer → VS Code: uses
README.md - VS Code → Extension Activation: activates
src/extension.ts - Extension Activation → Interpreter Selection: starts selection
src/extension.ts - Extension Activation → Helper Resolution: resolves helper
src/extension.ts - Helper Resolution → Download Transport: downloads through
src/downloader.ts - Helper Resolution → Engine Version Checks: checks versions
src/downloader.ts - Helper Resolution → Helper Installer: installs with
src/downloader.ts - Helper Resolution → Native PyPilot Engine: locates or downloads
src/downloader.ts - Extension Activation → Workspace Language Clients: starts clients
src/extension.ts - Workspace Language Clients → Native PyPilot Engine: runs per project
src/clients.ts - Extension Activation → Command Handlers: registers
src/extension.ts - Extension Activation → Workspace Tasks: registers
src/extension.ts - Extension Activation → Report Coordination: initializes
src/extension.ts - Command Handlers → Workspace Language Clients: selects client
src/commands.ts - Command Handlers → Status Bar: updates
src/commands.ts - Command Handlers → Project Detection: checks project
src/commands.ts - Command Handlers → Interpreter Selection: checks environment
src/commands.ts - Status Bar → Project Detection: reads manager
src/statusBar.ts - Status Bar → Interpreter Selection: reads environment
src/statusBar.ts - Interpreter Selection → Python Extension API: selects interpreter via
src/venv.ts - Project Detection → Interpreter Selection: detects pixi through
src/project.ts - Native PyPilot Engine → Doctor and Fixes: produces diagnosis and fixes
README.md - Native PyPilot Engine → Python Version Resolution: resolves supported versions
README.md - Native PyPilot Engine → CUDA and Driver Matching: matches CUDA wheels
README.md - Native PyPilot Engine → Import Diagnostics: checks imports
README.md - Report Coordination → Workspace Language Clients: requests details from
src/report.ts - Report Coordination → Interactive Report Panel: shows report in
src/report.ts - Interactive Report Panel → VS Code: exports or copies
src/webview/reportPanel.ts - Python Developer → Command Handlers: runs commands
README.md - Python Developer → Workspace Tasks: runs tasks
README.md - Python Developer → Interactive Report Panel: views report
README.md