Docs › Getting started › Install Tiger

Install Tiger

Tiger runs natively on macOS, Windows and Linux. All builds are published to GitHub Releases and the app checks for updates automatically in the background.

macOS
Signed and notarized DMG. Apple Silicon and Intel.
Windows
winget, Setup installer, or portable EXE.
Linux
AppImage (auto-updating) or Debian/Ubuntu .deb.

Download

All builds for the current release (v0.4.1) are on the GitHub Releases page. Pick the package for your platform below, or go straight to the releases page to see checksums and release notes.

View all downloads on GitHub Releases

macOS

Tiger is distributed as a signed and notarized .dmg for both Apple Silicon (arm64) and Intel (x64). Gatekeeper clears notarized apps on first launch, so you can open the DMG and drag Tiger to /Applications like any standard Mac application.

Install steps

  1. Go to github.com/jtaoufik/tiger/releases/latest and download the .dmg that matches your chip:
    • Tiger-0.4.1-mac-arm64.dmg - Apple Silicon (M1 and later)
    • Tiger-0.4.1-mac-x64.dmg - Intel
  2. Open the downloaded .dmg.
  3. Drag the Tiger icon to the Applications folder shortcut in the DMG window.
  4. Eject the DMG and open Tiger from Launchpad or /Applications.
✓

Because Tiger is notarized by Apple, you do not need to right-click and choose Open to bypass Gatekeeper. It launches normally on first double-click.

System requirements

macOS 12 Monterey or later. Both Apple Silicon and Intel are natively supported.

Windows

Tiger is available for Windows x64 in three forms: a winget package (recommended), a graphical Setup installer (NSIS), and a portable EXE that needs no installation. A .zip archive is also provided for manual extraction.

i

The Windows builds are not yet code-signed. Installing via winget skips the SmartScreen prompt entirely. If you use the Setup EXE or portable EXE directly, Windows SmartScreen may show a warning the first time you run the file. Click More info and then Run anyway to continue. This is a known limitation and will be resolved once Windows code signing is in place.

Option 1: winget (recommended)

Open a terminal and run:

winget install TaoufikJabbari.Tiger

winget downloads the verified package directly from the Windows Package Manager community repository. No SmartScreen prompt appears. Tiger is added to your Start menu and kept up to date by winget on subsequent winget upgrade runs.

Option 2: Setup installer

  1. Download Tiger-Setup-0.4.1-windows-x64.exe from the releases page.
  2. Run the installer. If SmartScreen appears, click More info then Run anyway.
  3. Follow the setup wizard. You can choose a custom install directory. Tiger is added to your Start menu and a desktop shortcut is created.

Option 3: Portable EXE

Download Tiger-Portable-0.4.1-windows-x64.exe. This is a self-contained executable that you can run from any folder or USB drive without installing anything. Right-click the file and choose Run as administrator if you need to write to a restricted folder; otherwise run it directly. User data is stored in %APPDATA%\Tiger regardless of where the EXE lives.

System requirements

Windows 10 or later, x64 architecture.

Linux

Tiger ships two Linux packages: an AppImage and a Debian/Ubuntu .deb. Both are x64 only in this release.

Option 1: AppImage

The AppImage is a single portable file that runs on most x64 Linux distributions without installing anything. It also supports background auto-updates via electron-updater, so Tiger will notify you when a new version is available and offer to download and apply it.

  1. Download Tiger-0.4.1-linux-x64.AppImage from the releases page.
  2. Make it executable: 
    chmod +x Tiger-0.4.1-linux-x64.AppImage
  3. Run it: 
    ./Tiger-0.4.1-linux-x64.AppImage

To integrate it with your desktop environment, move the AppImage to ~/.local/bin/ or any directory on your $PATH and create a .desktop file pointing to it. Some distributions ship appimaged or similar tools that handle this automatically when you place an AppImage in ~/Applications.

Option 2: Debian / Ubuntu .deb

The .deb package installs Tiger system-wide and integrates with apt.

  1. Download Tiger-0.4.1-linux-amd64.deb from the releases page.
  2. Install it with apt (preferred over dpkg - it resolves dependencies automatically): 
    sudo apt install ./Tiger-0.4.1-linux-amd64.deb
  3. Launch Tiger from your application menu or run tiger-api-client in a terminal.

To uninstall: sudo apt remove tiger-api-client.

i

The .deb package does not auto-update. Check the releases page for new versions, download the updated .deb, and re-run sudo apt install ./<new-file>.deb to upgrade in place. The AppImage auto-updates and is recommended if you want hands-free upgrades.

System requirements

x64 architecture. The AppImage is distribution-agnostic (glibc 2.17+). The .deb targets Debian 11+ and Ubuntu 20.04+.

Background auto-updates

Tiger checks for new releases at startup and periodically while running. When an update is available, a notification appears in the bottom of the window. Clicking it downloads the update in the background. On macOS and Windows the update installs the next time you quit and reopen the app. On Linux, auto-updates work for the AppImage only; the .deb package requires a manual download and reinstall.

Auto-update downloads come from GitHub Releases. No third-party update server is involved. You can also update manually at any time by downloading the latest package from the releases page and replacing the existing install.

Build from source

Tiger is MIT-licensed and the full source is on GitHub. To build it yourself you need Node.js 20+ and npm. 

git clone https://github.com/jtaoufik/tiger.git
cd tiger
npm install
npm run dev          # launch in development mode (hot-reload)
npm run package      # build a distributable for your current platform

npm run package builds the Electron app and the MCP server binary, then produces platform-appropriate packages in the release/ folder. See CONTRIBUTING.md for the full development setup.

Next steps