Installation
Install Zyron on macOS, Windows, or Linux and connect your first coding-agent runtime.
Zyron is a desktop workspace for coding agents. Installing Zyron gives you the workspace; provider runtimes and model access still come from the coding-agent tools and accounts you already use.
Choose the right installer
Download the latest stable build from the Zyron download page. If the automatic download is unavailable, open GitHub Releases and select the asset for your system.
| Platform | Download |
|---|---|
| macOS on Apple Silicon | Arm64 .dmg |
| macOS on Intel | x64 .dmg |
| Windows | x64 .exe installer |
| Linux on x86_64 | x86_64 .AppImage |
| Linux on ARM64 | arm64 .AppImage |
The download page offers both Linux builds; pick ARM64 if uname -m prints aarch64.
Zyron uses provider runtimes installed on your machine. Install and authenticate at least one provider—such as Claude Code, Codex, OpenCode, Cursor, or another supported runtime—before starting your first task.
Install Zyron
Download the application
Use the download page or an official GitHub release. Avoid third-party download mirrors.
Complete the platform installation
Open the downloaded installer and complete the normal installation flow for your operating system.
On Linux, your desktop environment may require making the AppImage executable before opening it:
chmod +x Zyron*.AppImageAppImages also need FUSE 2. If the AppImage does not start, install your distribution's FUSE 2
package (fuse2 on Arch, libfuse2t64 on Ubuntu 24.04+ and Debian trixie+, libfuse2 on older
Debian and Ubuntu releases) or extract it once:
./Zyron*.AppImage --appimage-extract
./squashfs-root/zyronInstall and authenticate a provider
Follow the provider's official installation and sign-in process. Zyron does not copy an account from another machine or replace the provider's own authentication.
Open a fresh terminal and confirm that the provider can start successfully outside Zyron. This separates provider installation problems from Zyron configuration problems.
Launch Zyron and check the provider
Open Zyron, go to provider settings, and confirm that the runtime is detected and available. Zyron discovers the models and options exposed by the installed runtime, so the choices can vary by provider version, account, and subscription.
Add a project
Choose a local project folder. A Git repository is strongly recommended because it enables branches, worktrees, diffs, commits, pushes, and pull-request workflows.
When a provider is not detected
Work through these checks in order:
- Open a new terminal window.
- Confirm that the provider executable runs there.
- Confirm that the provider is authenticated.
- Check whether Zyron offers a custom binary-path setting for that provider.
- Restart Zyron after changing your
PATHor installing a new runtime. - Continue with Troubleshooting if it remains unavailable.
Zyron normalizes the environment available to the desktop process, but provider installations and shell configurations differ across operating systems.
Updating Zyron
Packaged builds use Zyron's desktop updater. When an update cannot be applied automatically, download the newest installer and install it over the existing application.
The application bundle and local workspace data are stored separately. Even so, keep important work committed to Git before updating an early release.
Run without the desktop shell
Each GitHub release also includes zyron-server-<version>.tar.gz for a headless web installation. It requires a supported Node.js runtime and a production dependency install; it is not a standalone executable or a replacement for provider authentication.
Follow the Headless server guide for extraction, startup, readiness checks, data-directory ownership, and remote-access policy. Start loopback-only and do not expose the raw server port without deliberate authentication and trusted transport.
Zyron changes quickly. Keep valuable work committed and review release notes before relying on a new workflow for important repositories.
Next
Continue with the Quickstart, or review the provider overview first.
macOS minimum in 1.0.9
Zyron requires macOS 13 or later for its bundled native tools. Stable 1.0.9 packages declare that minimum and updater feeds refuse the update on older macOS systems. Choose the installer matching your processor. Packaged startup checks on macOS 15 do not establish runtime behavior on every macOS 13 configuration.
Source evidence for 1.0.9: Zyron release ebd0d22b39ce3a0f7c6051dddc6090e9b85dc7c3; docs/releases/1.0.9-source-audit.md, docs/providers.md, docs/core-concepts.md, docs/editor/intelligence.md, docs/mcp-connectors.md, apps/server/src/persistence/MigrationBackup.ts and docs/release.md.