Installation

Get Kibo installed on your machine in under a minute.

Prerequisites

  • Python 3.10 or higher
  • Git
  • Linux, macOS, or Windows (with WSL2)

Quick Install

Run this single command to install Kibo with all defaults:

curl -sL https://raw.githubusercontent.com/1dev-hridoy/Kibo/main/install.sh | bash

This will install Kibo to ~/kibo with the default model (Needle 2).

Custom Install

If you want to choose which AI model to install, download the script first:

curl -sLO https://raw.githubusercontent.com/1dev-hridoy/Kibo/main/install.sh chmod +x install.sh ./install.sh

This will give you the option to choose between Needle 2, FunctionGemma, or both.

Custom Install Directory

To install Kibo to a custom location, set the KIBO_DIR environment variable:

KIBO_DIR=/opt/kibo curl -sL https://raw.githubusercontent.com/1dev-hridoy/Kibo/main/install.sh | bash

What Happens During Install

  1. 1.
    System Check — Verifies Python and Git are installed
  2. 2.
    Download — Clones the Kibo repository
  3. 3.
    Virtual Environment — Creates an isolated Python environment
  4. 4.
    Install Package — Installs Kibo in editable mode
  5. 5.
    System Helpers — Installs optional system packages
  6. 6.
    Model Setup — Downloads and configures AI models

Verify Installation

After installation, verify everything is working:

cd ~/kibo && ./run.sh

Tip: If the install fails, make sure you have Python 3.10+ installed. On Ubuntu/Debian: sudo apt install python3 python3-venv

Next
Quick Start
Continue