Install Glueprint
Download Glueprint for macOS, Windows, or Linux, and pick the right surface for how you work.
- Topic
- Getting Started
- Available on
- Available onDesktopWeb PortalMobileCLI Daemon
- Reviewed
- October 8, 2026
On this page
Glueprint runs on every machine where you want an AI teammate working: your laptop, a remote server, or any browser. This page covers installing the desktop app, connecting it to your account, and running the headless daemon on a server.
What you’ll set up
- The web portal at portal.glueprint.ai, for account, billing, plan, and host management. Free provides a guided setup for its included desktop host; Pro, Team, and Enterprise provide Create Host for CLI daemons and the desktop’s alternative key-entry flow.
- The desktop app on macOS, Windows, or Linux. Where most people spend their day.
- Later, the mobile app on iOS and Android, once it is available in the public app stores.
- Optionally, the CLI daemon on a server, when you want sessions running 24/7 without a logged-in machine. New CLI-daemon hosts need Pro or above.
The desktop app works on its own: it opens straight into your local Workspaces, with no account required. Connect it to your Glueprint account when you want your plan’s features. Assistants, Channels and boards need Lite or above; live sessions in the web portal need Pro or above. Connecting starts in the app, continues in your browser, and finishes back in the app; you do not need to prepare a portal key first.
System requirements
| Surface | Requirements |
|---|---|
| Desktop | macOS 12+, Windows 10+, or Linux with WebKit2GTK 4.1+ (Ubuntu 22.04+, Fedora 36+, similar) |
| Portal | Any modern browser. No install. |
| Mobile | iOS 16+ or Android 10+ |
| CLI daemon | Any 64-bit Linux, macOS, or Windows machine that can run a long-lived process |
The desktop app is a single native binary. No Node.js, Python, or Java dependencies.
Connect the desktop to your account
When you are ready, click Local in the status bar at the bottom of the window and choose Connect to Glueprint. The same button appears on destinations that need an account, such as Channels. On Sign in to Glueprint, choose Sign in or Create account. Complete the browser flow, including recovery-code saving and email verification for a new account, then return to the desktop to name this machine or choose a host prepared for you.
If your organization uses single sign-on, follow its browser sign-in flow. Account management, billing, host revocation, and SSO setup remain available in the portal.
Install the desktop app
- Go to glueprint.ai/download and pick the installer for your platform.
- Install it the way you’d install any other app:
- macOS — open the disk image and drag Glueprint into Applications.
- Windows — run the installer and follow the wizard.
- Linux —
sudo dpkg -ithe.deb, or make the AppImage executable and run it.
- Launch the app. It opens in your local Workspaces, where the setup checklist walks you to your first session. To connect your account, follow Activate your account.
The desktop app updates itself in the background. Updates are cryptographically signed; the app verifies the signature before installing.
Install the mobile app
The iOS and Android app is not yet available in the public App Store or Google Play. Sign-in matches the portal: email + password, or SSO if your organization uses it.
Install the CLI daemon
The CLI daemon runs Glueprint as a background service on a server. Most users don’t need this on day one. Install it with one command:
curl -fsSL https://install.glueprint.ai | sh
This places the glueprint binary in ~/.glueprint/bin and adds it to your PATH. See CLI Daemon for activation, the full command reference, and running it as an OS service.
Where your data lives
Each surface stores data in its own place:
- Desktop — local files inside your user data directory (~/.glueprint by default, overridable with GLUEPRINT_ROOT).
- Portal — your account, billing, and any data you sync to the cloud relay live on Glueprint servers; the portal holds nothing locally beyond your session token.
- Mobile — credentials are stored in the OS secure storage (Keychain on iOS, Keystore on Android).
- CLI daemon — local files in the daemon’s data directory, identical layout to the desktop app.
Uninstalling the desktop app does not delete your local data. If you want a clean slate, delete the data directory after uninstalling.
Next step
Follow the setup checklist to your first session, and connect your account whenever you are ready.