Desktop install
macOS
Choose the latest Apple Silicon or Intel DMG, then complete the unsigned app first-run steps below if macOS blocks the app.
Downloads resolve to the latest published release automatically.
Install PyVessel
Install the desktop app and wire it into your local Python toolchain.
PyVessel runs locally on macOS, Windows, and Linux. Download the latest build from the install buttons below, complete the platform-specific first-run steps, and make sure the VS Code and Zed CLI commands are available on PATH.
We will try to detect the right platform automatically, or you can choose a build below.
macOS note
Unsigned app guidance is included below.
Editor launch
Install the code and zed CLIs before relying on editor launch from PyVessel.
Downloads
Choose your platform and download the latest release.
Each button resolves to the latest matching release asset automatically. Pick the artifact that matches your operating system, then follow the notes below.
Desktop install
Windows
Download the latest Windows installer or MSI package, then launch PyVessel locally with your normal user account.
Downloads resolve to the latest published release automatically.
Desktop install
Linux
Pick the latest AppImage, .deb, or .rpm build, make it executable if needed, and start using PyVessel for local Python projects.
Downloads resolve to the latest published release automatically.
macOS unsigned install
If macOS blocks the app, use the practical unsigned first-run steps.
This is the section people should actually follow on macOS. It is short on purpose and written for the real first-run flow.
1
Download the latest macOS build from the install buttons on this page.
2
Open PyVessel once from Finder.
3
If macOS blocks the app, open System Settings > Privacy & Security and choose Open Anyway.
4
If Finder still blocks the app, try right-click > Open to reveal the allow dialog.
Enable Editor CLI Commands
Make VS Code and Zed discoverable before using editor launch from PyVessel.
PyVessel can launch editors for the active project, but it depends on the CLI command being installed on PATH or the app being discoverable on your machine.
Install the code command on PATH.
- 1. Open VS Code.
- 2. Open the Command Palette.
- 3. Run Shell Command: Install 'code' command in PATH.
- 4. Open a new terminal window and verify with
code .
Make sure the zed command is available on PATH.
- 1. Prefer Zed’s built-in CLI install flow if the app offers it.
- 2. Otherwise add the binary to PATH manually.
- 3. On macOS or Linux, a manual symlink can look like this:
sudo ln -s /Applications/Zed.app/Contents/MacOS/zed /usr/local/bin/zed
Linux users can link the installed zed binary into
/usr/local/bin if needed, then verify with
zed .
Troubleshooting
Quick fixes for the most common local setup snags.
PyVessel will not open on macOS
The current app may be unsigned. Launch it once, then use System Settings > Privacy & Security > Open Anyway. If that does not appear, try right-click > Open on the app bundle.
The code command is not found
Open VS Code, launch the Command Palette, and run Shell Command: Install 'code' command in PATH. Open a new terminal session and verify with code .
The zed command is not found
Use Zed’s built-in CLI install flow if available. Otherwise add the zed binary to PATH manually, then open a fresh terminal and verify with zed .
PyVessel cannot open my editor
Editor launching depends on the CLI command being installed on PATH or the app being discoverable on your machine. Confirm code and zed work directly in a terminal before testing the launch action again.
Ready to install
Download PyVessel, unblock the editor CLIs, and get back to your local Python workflow.
The guide stays practical on purpose: install the app, handle the macOS first-run prompt if needed, and make sure code and zed work in a terminal.