Download & Install

Grab the latest Whiskers release and follow the quick‑start guide for your platform.

Get Whiskers v1.0

Current Version

v1.0

Verify downloads using the checksum when available.

View on GitHub Releases

Linux Setup

Install the dependencies and create a virtual environment:

sudo apt update
sudo apt install python3 python3-venv python3-pip curl -y
cd whiskers
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Once installed, continue with the server and model setup.

macOS Setup

Verify that Python 3.10+ is installed:

python3 --version

If needed, install Python from python.org. Then set up Whiskers:

cd whiskers
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Windows (WSL2) Setup

Enable the Windows Subsystem for Linux and install Ubuntu:

wsl --install

Reboot, then open Ubuntu and install dependencies:

sudo apt update
sudo apt install python3 python3-venv python3-pip curl build-essential cmake git -y
cd /mnt/c/Users/<YOURNAME>/Desktop/whiskers
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Next Steps

After installing Whiskers you need to run a local llama.cpp server and download a model. See the Docs for detailed instructions on installing llama.cpp, fetching a model and starting the server.