Installation

KDeps requires minimal dependencies to get started. The only requirements are:

• KDeps CLI - The command-line interface
• Docker (optional) - Only needed for building container images

Installing KDeps CLI

macOS (Homebrew)

brew install kdeps/tap/kdeps

Linux, macOS, and Windows (curl)

curl -LsSf https://raw.githubusercontent.com/kdeps/kdeps/main/install.sh | sh

Windows (wget in WSL or Git Bash)

wget -qO- https://raw.githubusercontent.com/kdeps/kdeps/main/install.sh | sh

Note for Windows Users: For optimal functionality, run the installation command using either Git Bash or WSL.

From Source

Option 1: Go Install (Recommended)

go install github.com/kdeps/kdeps/v2@latest

Option 2: Build Manually

git clone https://github.com/kdeps/kdeps.git
cd kdeps
go build -o kdeps main.go
./kdeps --version

Verify Installation

kdeps --version

You should see output like:

kdeps version 2.0.0

Docker (Optional)

Docker is only needed if you want to build container images for deployment. For local development and testing, KDeps runs natively without Docker.

Install Docker

• macOS: Docker Desktop for Mac
• Windows: Docker Desktop for Windows
• Linux: Docker Engine

Verify Docker Installation

docker --version

Ollama (Optional)

For local LLM inference, KDeps uses Ollama as the default backend. If you want to use local LLMs:

Install Ollama

# macOS / Linux
curl -fsSL https://ollama.ai/install.sh | sh

# Or download from https://ollama.ai/download

Pull a Model

ollama pull llama3.2:1b

Note: KDeps can automatically download models when you run a workflow, so manual model pulling is optional.

Troubleshooting

Permission Denied Error

If you encounter a Permission Denied error during installation:

curl -LsSf https://raw.githubusercontent.com/kdeps/kdeps/main/install.sh | sudo sh

Command Not Found

If kdeps is not found after installation, add ~/.local/bin to your PATH:

# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Then reload your shell:

source ~/.bashrc  # or source ~/.zshrc

Docker Permission Issues (Linux)

If you get permission errors when running Docker commands:

sudo usermod -aG docker $USER
# Log out and back in for changes to take effect

Next Steps

• Quickstart Guide - Build your first AI agent
• CLI Reference - Complete command reference
• Workflow Configuration - Learn about workflow settings
• Examples - Browse example workflows