Getting Started
Installation
Quick answer
Prism is a single binary with no runtime dependencies. Windows ships a per-user MSI that needs no administrator prompt, plus a portable executable; macOS ships a signed and notarised DMG; Linux ships a portable AppImage and a tarball. Every release publishes each artifact twice, once version-stamped and once under a stable unversioned alias.
Last updated Reviewed against Prism v0.3.26
Download
Grab the latest release from GitHub. Both the version-stamped name and the unversioned alias resolve to the same file, so either URL keeps working across releases.
| Platform | Artifact | Stable URL |
|---|---|---|
| Windows installer | Per-user MSI | /releases/latest/download/Prism-Windows-x64.msi |
| Windows portable | prism.exe | /releases/latest/download/prism.exe |
| macOS | Notarised DMG | /releases/latest/download/Prism-macOS.dmg |
| macOS (auto-update) | tar.gz | /releases/latest/download/Prism-macOS.tar.gz |
| Linux | AppImage (x86_64) | /releases/latest/download/Prism-Linux-x86_64.AppImage |
| Linux (auto-update) | tar.gz | /releases/latest/download/Prism-Linux.tar.gz |
# Windows portable (PowerShell) Invoke-WebRequest -Uri https://github.com/KavinMK05/Prism/releases/latest/download/prism.exe -OutFile prism.exe # macOS curl -LO https://github.com/KavinMK05/Prism/releases/latest/download/Prism-macOS.dmg # Linux curl -LO https://github.com/KavinMK05/Prism/releases/latest/download/Prism-Linux-x86_64.AppImage chmod +x Prism-Linux-x86_64.AppImage
Windows installer (per-user MSI)
The MSI installs for the current user only. There is no UAC elevation, no machine-wide service, and no administrator involvement.
| Property | Value |
|---|---|
| Install directory | %LOCALAPPDATA%\Programs\Prism |
| Install state | HKCU\Software\Prism (InstallType, InstallDir, InstalledVersion) |
| Shortcut | Start Menu entry, created on install |
| Elevation | None — per-user package |
| Updates | In-app, applied with msiexec |
| Uninstall | Removes the app; keeps %APPDATA%\prism so your config and stats survive |
Upgrading an older install
Windows requires installer versions to increase. Prism stamps each MSI with the release version so an upgrade over an existing install is accepted, and it adopts a stale auto-start entry rather than leaving two pointing at different paths.
First run
1
Launch Prism
Run the installed app or the portable binary. A tray icon appears immediately and the proxy starts on
127.0.0.1:11434. Nothing else is required.2
Open the Admin UI
Go to
http://127.0.0.1:8765/admin. The Connect tab shows the live service URLs and the shared token.3
Add a provider
In the Provider tab, add Ollama Cloud, OpenCode Go, a custom OpenAI-compatible provider, or a Codex account via OAuth. See Provider Setup.
4
Connect an agent
Go to the Agents tab, find your installed agent, and click Setup. Prism backs up the existing config and writes the right one. See Agent Integrations.
System requirements
| Requirement | Value |
|---|---|
| Operating system | Windows 10+, macOS 11+, or a modern Linux desktop |
| Architecture | x86_64 / AMD64 |
| Runtime dependencies | None. No Python, Node.js, Docker or package manager |
| Disk | Small; the managed SearXNG runtime adds roughly 80 MB only if you start it |
| Network | Only outbound calls to the providers you configure |
Headless install
On a server you can skip the tray and run the proxy in the foreground with prism --serve. All provider, routing and search behaviour is identical.
File locations
| Platform | Config directory |
|---|---|
| Windows | %APPDATA%\prism\ |
| macOS | ~/Library/Application Support/prism/ |
| Linux | $XDG_CONFIG_HOME/prism/ (default ~/.config/prism/) |
config.json # settings model_remapping.json # models, providers and aliases stats.db # request statistics (SQLite, WAL) searxng/ # managed SearXNG runtime (only if started) logs/ # log files (Linux; Windows and macOS log here too)
Related
Quick Start
From install to a working proxy in under two minutes.
Provider Setup
Connect Ollama Cloud, custom providers and Codex OAuth.
Auto-Start
Launch Prism automatically at login.
Troubleshooting
Install, port and startup problems.
Guide: Linux setup
AppImage, FUSE, the tray icon, autostart and headless --serve.
Guide: Windows without admin
The per-user MSI and the portable exe, compared.