Installation
Install Empryo on macOS, Linux, or Windows x64 with the official command-line installer or the desktop app, then check the install and connect a model.
Copy & share
On this page4 sections
Choose your platformLink to this section
You can install Empryo on:
- macOS on Apple Silicon or Intel.
- Linux on x64 or ARM64.
- Windows 10 (version 1809 or later) and Windows 11 on x64 only. Windows on ARM is not supported.
There are two ways to install. The command-line installer gives you the terminal UI and headless mode. The desktop app is a separate download and works on its own. Empryo is not published on npm or Homebrew, so use the options below.
curl -fsSL https://empryo.com/install.sh | bashThe script detects your system, downloads the matching release, and checks its SHA-256 checksum before installing. You can read the script before you run it.
irm https://empryo.com/install.ps1 | iexRun this in PowerShell. You can read the script first. You can also get it from the Microsoft Store as Empryo CLI, which updates through the Store. If you want a portable install instead, download the ZIP from the download page and keep the deps/ folder next to empryo.exe.
Pick the installer for your system on the download page:
- macOS:
.dmgfor Apple Silicon or Intel. - Linux: AppImage, or a distribution package where one is offered, for x64 or ARM64.
- Windows: the Microsoft Store, or the setup or portable
.exefor x64.
Install it, launch it, and open your project folder. You don't need the command-line install to use the desktop app.
The Microsoft Store version updates through the Store. It can't download add-ons for you: install an add-on yourself and Empryo uses the copy on your PATH.
If Windows SmartScreen shows a warning, check that the file came from the official download page before you continue. Never skip a security warning for a file you don't trust.
Check the CLI installationLink to this section
If your shell says empryo is not found, open a new terminal first. Then run:
empryo --version
empryo doctor--version shows that the command is on your PATH. doctor checks that Empryo's runtime and native libraries load correctly, which can catch problems a version check misses. If either command fails, see troubleshooting.
You don't need Neovim, a Nerd Font, or any extra tools for your first conversation. Local models need their own model server installed and running.
Windows notesLink to this section
Windows is fully supported on x64, Windows 10 1809+ and Windows 11. Windows on ARM is not supported, because some native libraries Empryo depends on have no ARM64 Windows build and can't load under x64 emulation.
| Feature | Windows |
|---|---|
| Terminal UI, headless mode, desktop app | Supported |
| Saved keys and tokens | Encrypted with Windows DPAPI and stored in %LOCALAPPDATA%\Empryo\secrets.dat, readable only by your Windows account |
| Floating terminal inside the terminal UI | Off by default on Windows |
| Neovim editor panel | Needs Neovim installed and on your PATH |
| Everything else | Same agent, same config file, same sessions |
When a feature isn't available on Windows, Empryo labels it in place instead of hiding it, so you can tell a platform limit from a bug.
If empryo is not found after installing, see command not found after install.
Next: connect a modelLink to this section
You need access to a model, but not necessarily an API key. You can sign in with a supported subscription, add a provider key, or use a local model. The quickstart walks you through each option and your first task. For tailored commands, use the guided setup.