Installation

Askimo can be installed in several ways depending on your operating system and preference. Choose the method that works best for your workflow.

🔐 Security Note

Askimo stores your API keys only on your device and encrypts them before saving. Read how we protect your data → How Askimo Protects Your Data

Installation Options by OS

Method	macOS	Linux	Windows	Notes
Homebrew	✅	✅	❌	Easiest on macOS/Linux
Scoop	❌	❌	✅	Easiest on Windows
Release Binaries	✅	✅	✅	Manual install, works anywhere
Docker	✅	✅	✅	No local install needed

---

1. Homebrew (macOS / Linux)

The easiest way if you’re on macOS or Linux.

brew tap haiphucnguyen/askimo
brew install askimo
askimo

Update later:

brew upgrade askimo

2. Scoop (Windows)

The easiest way if you’re on Windows.

Install Scoop if you don’t have it:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
iwr -useb get.scoop.sh | iex

Add the Askimo bucket and install:

scoop bucket add askimo https://github.com/haiphucnguyen/scoop-askimo
scoop install askimo
askimo

Update later:

scoop update
scoop update askimo

3. Download Release Binaries (macOS / Linux / Windows)

Prebuilt binaries are available on the Releases page

• Download the archive for your OS.

• Extract it.

• Move the binary into a directory on your $PATH.

Example (macOS/Linux):

mv askimo /usr/local/bin/
chmod +x /usr/local/bin/askimo
askimo

On Windows, move askimo.exe into a folder included in your PATH.

4. Docker (macOS / Linux / Windows)

Run Askimo inside a container without installing anything locally.

IMAGE=ghcr.io/haiphucnguyen/askimo:latest   # or specific tag like :v0.1.10
docker run --rm -it \
  -v "$HOME/.askimo:/home/nonroot/.askimo" \
  -v "$PWD:/home/nonroot/work" \
  -w /home/nonroot/work \
  $IMAGE

• ~/.askimo on your machine is mounted for local provider settings/keys.

• Your current folder is mounted so Askimo can read/write your project files.

Pipe input:

cat logs.txt | docker run --rm -i \
  -v "$HOME/.askimo:/home/nonroot/.askimo" \
  -v "$PWD:/home/nonroot/work" \
  -w /home/nonroot/work \
  ghcr.io/haiphucnguyen/askimo:latest "Summarize it"

---

Troubleshooting

• Command not found → Make sure askimo is in your $PATH.
• macOS Gatekeeper blocks the binary → Run:

xattr -d com.apple.quarantine askimo

• Windows Execution Policy issues → Run PowerShell as Administrator and use:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser