Installation

Sirius runs natively on the three desktop platforms. Pick the right installer and verify the SHA-256 signature before running it.

Download

OS	Format	Notes
Windows 10+	.exe	Signed installer, autoupdates
Linux	.deb, .rpm, AppImage	AppImage works on any modern distro
macOS arm64 + x86_64	.dmg	Notarized

Latest version + checksums: sirius-ide.com/download.

Verify the signature

# Linux / macOS
shasum -a 256 sirius-1.0.0.dmg
# Expected: <hash from /download page>

# Windows (PowerShell)
Get-FileHash .\Sirius-1.0.0-setup.exe -Algorithm SHA256

If the hash differs from the value on the download page, do not run the installer — re-download it from the official site.

The sirius:// link handler (security note)

Sirius registers a custom sirius:// URL protocol so the website can hand a sign-in session to the desktop app. On Windows this handler lives in the per-user registry (HKCU), which any program running as your user can overwrite — this is a platform limitation, not specific to Sirius.

What this means in practice:

• Prefer the official installer to register the handler. After installing other apps that claim custom protocols, you can re-run the installer to make sure sirius:// still points to Sirius.
• Hand-off tokens passed over sirius:// are one-time and short-lived, and are wiped from the process arguments immediately, so they never appear in logs or the process list.
• No long-lived secrets (your OpenRouter key, JWT secret) are ever passed through the link.

If clicking Connect IDE opens an unexpected window, decline it and re-register the handler by reinstalling from the official site.

Install from source

For contributors and security-conscious users:

git clone https://github.com/sirius-ide/sirius
cd sirius
python -m venv .venv
source .venv/bin/activate         # PowerShell: .venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m sirius

Once the public release lands you’ll also be able to run:

pip install sirius-ide
sirius