Navin
Back to downloads

Documentation

Installation guide

Follow the steps for your operating system - it takes less than two minutes.

Terminal

Run agents in any terminal or script, with integrations to your preferred IDEs.

curl https://navin.live/install -fsS | bash

Then, in a project folder:

cd your-project && navin-cli

navin-cli opens the terminal UI in that folder: chat, tools, settings, sessions, graph, evolve. navin . opens the same folder in the desktop window.

Linux

Four formats: .deb (Ubuntu/Debian), .rpm (Fedora/CentOS/SUSE), pacman (Arch/Manjaro/Omarchy), and AppImage (any distro). Then open a project.

1. Pick a format

  • .deb - Ubuntu, Debian, Linux Mint, Pop!_OS, WSL. Dependencies install with the package.
  • .rpm - Fedora, CentOS, RHEL, Alma, Rocky, openSUSE. Dependencies install with the package.
  • pacman - Arch, Manjaro, Omarchy. Dependencies install with the package.
  • AppImage - Any distribution. Portable - no Navin system installer, but install system dependencies once first.
2. Install - Debian / Ubuntu (.deb)

Dependencies (theme, emoji fonts) are pulled automatically by apt.

sudo apt install ./navin_*_amd64.deb

3. Launch Navin

navin-desktop
2. Install - Fedora / CentOS / openSUSE (.rpm)

Dependencies are pulled automatically by the package manager.

Fedora:

sudo dnf install ./navin-*.x86_64.rpm

CentOS / RHEL / Alma / Rocky:

sudo yum install ./navin-*.x86_64.rpm

openSUSE:

sudo zypper install ./navin-*.x86_64.rpm

3. Launch Navin

navin-desktop
2. Install - Arch / Manjaro / Omarchy (pacman)

Dependencies (webkit2gtk-4.1, gtk3, libayatana-appindicator, hicolor-icon-theme, adwaita-icon-theme, noto-fonts-emoji) are pulled automatically by pacman.

sudo pacman -U ./navin-*-x86_64.pkg.tar.zst

3. Launch Navin

navin-desktop
2. Install - AppImage (any distribution)

No system install of Navin. Install dependencies for your distro first, then run the file.

Dependencies (once)

FUSE (to mount the AppImage) + theme + emoji fonts.

Ubuntu / Debian / WSL

sudo apt install libfuse2 adwaita-icon-theme fonts-noto-color-emoji

Fedora

sudo dnf install fuse fuse-libs adwaita-icon-theme google-noto-emoji-color-fonts

CentOS / RHEL / Alma / Rocky

sudo dnf install fuse fuse-libs adwaita-icon-theme google-noto-emoji-fonts

openSUSE

sudo zypper install libfuse2 adwaita-icon-theme google-noto-coloremoji-fonts

Arch / Manjaro

sudo pacman -S fuse2 adwaita-icon-theme noto-fonts-emoji

Launch the AppImage

chmod +x Navin-*.AppImage && ./Navin-*.AppImage

Without FUSE: ./Navin-*.AppImage --appimage-extract-and-run

Windows + WSL (WSLg)

In Ubuntu WSL2: install the .deb, then launch. The window opens through WSLg.

sudo apt install ./navin_*_amd64.deb && navin-desktop

Under WSLg, the title bar stays basic. Navin applies 125% zoom (Ctrl + / Ctrl - to adjust).

4. Open a project

From a terminal, in the project folder (or with a path):

navin-cli
navin-cli ~/projects/mon-app
navin .
navin ~/projects/mon-app

navin-cli is the terminal UI (chat, tools, settings, graph, evolve) in that folder. navin . opens the folder in the desktop window.

Or from the app: + New Agent, then pick the project folder.

Windows
  1. 1

    Download Navin Setup (.exe) or the .msi package from the downloads page.

  2. 2

    Double-click the downloaded file to start the installer.

  3. 3

    Windows SmartScreen may show "Windows protected your PC" - click "More info", then "Run anyway".

  4. 4

    Follow the installer, then launch Navin from the Start menu.

This warning appears because Navin is a new publisher still building reputation with Microsoft, not because of a threat - it fades away on its own as more people install the same signed build.

The navin command, everywhere

Once installed, navin and navin-cli are available in PowerShell, cmd.exe and inside every WSL distribution. From a project folder, navin-cli opens the terminal UI there and navin . opens the folder in the editor.

navin-cli
navin .
macOS
  1. 1

    On the downloads page, pick Apple Silicon if it is listed, otherwise Intel (x64).

  2. 2

    Open the .dmg and drag Navin into the Applications folder.

  3. 3

    On first launch, macOS may refuse to open it because "the developer cannot be verified".

  4. 4

    Right-click (or Control-click) the Navin icon, choose "Open", then confirm - this is only needed once.

Alternatively: open System Settings > Privacy & Security, scroll to Security, then click "Open Anyway" next to the Navin message.

Verify your download (optional)

Every release publishes a SHA256SUMS.txt file next to the binaries. Compare it against your downloaded file before installing.

sha256sum -c SHA256SUMS.txt

Still stuck? Reach us at contact@navinspire.com

Installation guide - Navin