Installation ​

Install the kdeps CLI to start building agents locally. Docker is optional -- only needed if you want to build container images for deployment.

Installing KDeps CLI ​

macOS (Homebrew) ​

bash
brew install kdeps/tap/kdeps

Linux, macOS, and Windows (curl) ​

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

Windows (PowerShell) ​

powershell
irm https://raw.githubusercontent.com/kdeps/kdeps/main/install.ps1 | iex

Installs kdeps.exe into %USERPROFILE%\.local\bin and adds it to your user PATH. To pin a version or choose a different directory:

powershell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/kdeps/kdeps/main/install.ps1))) -Tag v2.1.15 -BinDir C:\tools\bin

Windows (wget in WSL or Git Bash) ​

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

Note for Windows Users: Git Bash or WSL also work if you prefer the shell-based installer above.

From Source ​

Option 1: Go Install (Recommended)

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

Option 2: Build Manually

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

On Windows without make (or Git Bash/WSL), build.ps1 and build.bat in the repo root do the same build with version/commit info embedded, matching make build:

powershell
.\build.ps1
cmd
build.bat

Verify Installation ​

bash
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 ​

Verify Docker Installation ​

bash
docker --version

Local LLMs (no install needed) ​

For local LLM inference, KDeps uses llamafile as the default backend (file): models are single self-contained binaries that kdeps downloads to ~/.kdeps/models/ and serves locally - no server install, no GPU, no API key. The default model alias llama3.2:1b resolves to Mozilla's Llama 3.2 1B Instruct llamafile (~1.1 GB, downloaded on first run).

bash
kdeps llamafile list      # see all known model aliases
kdeps llamafile update    # refresh the registry from HuggingFace

First-run setup ​

The first time you run kdeps in a terminal with no ~/.kdeps/config.yaml, an interactive wizard asks how you want to run language models and writes the config for you:

text
  How should kdeps run language models?
    [1] llamafile  local, self-contained, no server install (recommended)
    [2] gguf       local GGUF models via llama.cpp
    [3] cloud      OpenAI, Anthropic, DeepSeek, Groq, xAI, ... (needs an API key)
    [4] ollama     connect to an Ollama server
    [5] router     route across multiple models by strategy (advanced)
    [6] m365       Microsoft 365 Copilot (browser login, no API key)
    [0] Skip (configure later)

Each choice fills in the matching llm: fields:

  • llamafile / gguf — sets backend and a default model.
  • cloud — sets backend, prompts for the provider's API key, and stores it under llm.<provider>_api_key.
  • ollama — sets backend: ollama and the host URL.
  • router — collects the models to route across and a strategy (fallback, round_robin, token_threshold, cost_optimized), written as llm.models + llm.strategy.
  • m365 — sets backend: m365. No API key: authenticates via a browser-cached Microsoft 365 sign-in (or headless credentials for CI/servers). See LLM Provider Reference — M365 Copilot.

In non-interactive environments (CI, pipes) kdeps skips the wizard and writes a fully commented template instead. Re-run the wizard any time by removing ~/.kdeps/config.yaml, or edit it directly with kdeps edit.

Ollama (Optional) ​

To use Ollama instead of the default llamafile backend:

bash
# macOS / Linux
curl -fsSL https://ollama.ai/install.sh | sh
ollama pull llama3.2:1b

Then select it in ~/.kdeps/config.yaml:

yaml
llm:
  backend: ollama  # default is "file" (llamafile)

Troubleshooting ​

Permission Denied Error ​

If you encounter a Permission Denied error during installation:

bash
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:

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

Then reload your shell:

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

Docker Permission Issues (Linux) ​

If you get permission errors when running Docker commands:

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

See Also ​

Released under the Apache 2.0 License.

Copyright © 2024-present KDeps Contributors