Installation

Download, install, and configure Hyperia on your machine.

Download

Grab the latest release for your platform from GitHub.

https://github.com/DeepBlueDynamics/hyperia/releases

Windows

Run the .exe installer. Per-user install by default — no admin rights required. Hyperia will appear in your Start menu and %LOCALAPPDATA%\Programs\Hyperia.

The installer includes the Rust sidecar binary (hyperia-sidecar.exe) and the CLI wrapper. Both are added to your PATH at install time.

macOS

Open the .dmg, drag Hyperia.app to Applications, and launch. macOS will verify the notarization on first open.

If Gatekeeper prompts you despite notarization, right-click the app and choose Open once to approve it.

Linux

Debian / Ubuntu

sudo dpkg -i hyperia-{version}-amd64.deb

AppImage (universal)

chmod +x Hyperia-{version}.AppImage
./Hyperia-{version}.AppImage

RPM (Fedora / RHEL)

sudo rpm -i hyperia-{version}.x86_64.rpm

First launch

On first launch Hyperia opens a terminal tab using your system's default shell. The Rust sidecar starts in the background on port 9800.

The toolbar appears at the top center of the window. Hover over it to reveal buttons for new tabs, windows, sticky notes, and web panes.

Agent setup

Open Settings from the hamburger menu or press the settings shortcut. The Settings window lets you configure the AI agent model and token.

Using Ollama (no token required)

If you have Ollama installed locally, Hyperia works out of the box with no API key. Select a local model from the dropdown:

ollama pull gemma4          # fast, default
ollama pull gemma4:31b      # larger, slower

Select Gemma4 e2b — local, fast (default) from the model list and click Enable. No token is needed.

Using Anthropic Claude

Select a Claude model and enter your Anthropic API key. The key is stored in ~/.hyperia/hyperia.json and never transmitted anywhere except the Anthropic API.

Config file

Hyperia stores all configuration in a single JSON file:

~/.hyperia/hyperia.json     # macOS / Linux
%USERPROFILE%\.hyperia\hyperia.json   # Windows

You can edit this directly or use the Edit Config button in Settings, which opens it in your system editor. A factory reset (Settings → Factory Reset) reverts to defaults while preserving your agent token.