System Requirements
Hardware
- RAM: Minimum 8GB, recommended 16GB+
- Storage: At least 4GB free
- Processor: Intel x86-64, Apple Silicon, or ARM64
Operating System
Additional Requirements
- Internet: Required for AI features
- AI Provider Authentication: Required (API key or OAuth login, depending on provider — see Quick Start)
- Git: Optional but recommended
Install via Homebrew (macOS/Linux)
The easiest way to install Reliant on macOS and Linux is via Homebrew.Homebrew must be installed first. Visit brew.sh if you don’t have it.
Direct Download
Not sure which Mac? Check Apple menu → About This Mac → ChipLinux users: After downloading, make the AppImage executable and run it:
Build from Source
Reliant is open source on GitHub. You can build the full Electron desktop app or just the Go backend CLI.Prerequisites
- Go 1.25+ (see
go.mod) - Node.js 18+
- Make
Electron Desktop App
Clone and run the full desktop application with hot reload:Go CLI Only
If you only need the backend CLI (no Electron/UI):dist/reliant. Move it somewhere on your $PATH:
go install:
Pointing at your own stack
Self-hosting, or running against a local dev stack? Override the server, and the gateway when it isn’t on the same host:The gateway is a separate process from the API server — it is the only one
that serves the daemon’s connection stream. On a cloud host the daemon derives
the gateway from the server automatically; on localhost it cannot guess the
port, so set
--gateway (or RELIANT_GATEWAY_URL) explicitly. Without it the
daemon dials the API server and fails with a 404.See CONTRIBUTING.md for the full development setup guide.
Post-Installation
- Launch Reliant from Applications (macOS), Start Menu (Windows), or run the AppImage (Linux)
- Open a project folder or create a new one
- Configure your API key — see Quick Start
Updating
Via Homebrew
Via Source
Manual
Go to Reliant → Check for Updates, or download and install the latest version over your existing installation.Uninstalling
Homebrew
macOS Manual
- Quit Reliant
- Drag from Applications to Trash
- Remove settings (optional):
Windows
- Quit Reliant
- Settings → Apps → Installed Apps → Reliant → Uninstall
- Remove settings (optional): Delete
%APPDATA%\Reliant
Linux
- Quit Reliant
- Delete the AppImage file
- Remove settings (optional):
Next: Quick Start — Configure your API key and start chatting