Skip to main content

Installation

neokapi ships two artifacts you can install independently:

  • the kapi CLI — a single self-contained binary that runs offline by default and operates directly on your files;
  • Kapi Desktop — the visual companion app, which bundles the CLI.

The two sections below cover each. If you only want the command line, you need the first section alone.

Install the Kapi CLI​

Once you've tried kapi in the browser, install the binary to run it locally against your own files.

Homebrew (macOS/Linux)​

brew install neokapi/tap/kapi-cli

WinGet (Windows)​

winget install Neokapi.Kapi

Binary Downloads​

Pre-built binaries for all platforms are available on the GitHub Releases page:

  • Linux (amd64, arm64)
  • macOS (amd64, arm64)
  • Windows (amd64, arm64)

From source (Go developers)​

Install the latest with Go:

go install github.com/neokapi/neokapi/kapi/cmd/kapi@latest

Or build the repository:

git clone https://github.com/neokapi/neokapi.git
cd neokapi
make build       # Build kapi CLI → bin/kapi

Verify the install​

kapi version

Add a provider credential (optional)​

The rule-based commands — pseudo-translate, word-count, brand checks against a profile file — need no credential. For LLM-backed translation, QA, and review, save a provider key once under a name you'll reference in flows:

kapi credentials add my-openai --provider openai --api-key sk-…
kapi credentials list       # see what's saved

Credentials live in your OS keychain. See the Quick Start for what to run next.

Install Kapi Desktop​

Kapi Desktop is the visual companion to the CLI. Each package below installs the kapi CLI as a dependency, so a single install covers both. See the Kapi Desktop overview for what it does.

macOS (Homebrew)​

brew install --cask neokapi/tap/kapi

Windows (installer)​

Download and run the signed installer from GitHub Releases:

  • amd64: kapi-desktop-X.Y.Z-windows-amd64-setup.exe
  • arm64: kapi-desktop-X.Y.Z-windows-arm64-setup.exe

The installer is Authenticode-signed and registers a Start-menu entry and uninstaller.

Manual download (macOS, Linux)​

Download the latest release from GitHub Releases:

  • macOS: kapi-desktop-X.Y.Z-macOS-arm64.dmg (Apple Silicon)
  • Linux: kapi-desktop-X.Y.Z-linux-amd64.tar.gz or kapi-desktop-X.Y.Z-linux-arm64.tar.gz