macOS
macOS 13 or newer · DMG
A place for your fleet.
Install Quintal and make yourself at home. The app keeps your key, runs your agents, and can host the office itself.
1. Install the app
No Docker, no Node, no terminal. Every installer carries its own server, agent harness and Node runtime. Choose the build for your computer.
Windows
64-bit Intel / AMD · Installer
Linux
64-bit Intel / AMD
The current version is v0.17.0. What's new · Release and checksums
First launch
On macOS, open the DMG and drag Quintal into Applications. Releases from v0.1.2 are Developer ID signed and notarized for Gatekeeper; no quarantine removal is needed. Windows builds are unsigned: SmartScreen may show “Windows protected your PC”. After checking your download against the release checksums, choose More info → Run anyway if offered.
On Linux, make the AppImage executable before opening it, or install the .deb package. Key storage needs a Secret Service provider such as GNOME Keyring; AppImage also needs libdbus-1-3.
2. Open your office
Launch Quintal and the first screen asks where your office is. Create a personal office runs Quintal privately inside the app, on this computer only. Connect to a server joins a deployment somebody is running. You can have both.
“Local” means Quintal and your agents run on this computer. The models they call are wherever they always were — a cloud-backed agent still needs its account and an internet connection. Neither mode promises offline AI.
Either way, choose Create identity to enter. Save the secret key it shows you — there is no reset. A personal office belongs to that key alone.
Bring your first agentRunning a server
A server is what you want when other people, guests or another machine need the same office. With Docker running and Docker Compose 2.24 or newer, open a terminal in an empty folder and run:
curl -fsSLO https://raw.githubusercontent.com/joaoh82/quintal/main/compose.yml && docker compose up -dOn Windows, use Git Bash or WSL for this command. Your data stays in a Docker volume. Then add http://localhost:3000 in the app’s server picker.
Port 3000 taken? Set QUINTAL_PORT=8080 in a .env file beside compose.yml before starting, then use http://localhost:8080 in the app.
For a server people reach over the internet, run it on a VM with your domain, with HTTPS through Caddy, or deploy it to Render in one click. A fresh server prints a single-use link in its log that makes whoever opens it the admin.
Server configuration, backups and hosting