Installation

Kdeps requires three key components to operate effectively:

• Kdeps CLI Application: The primary command-line interface for Kdeps. Kdeps CLI GitHub Repository.
• Apple's PKL Programming Language: A specialized programming language developed by Apple, which is integral to Kdeps. Apple PKL Official WebsiteL.
• Docker: A powerful containerization tool used to build and manage AI Agent images and containers. Docker Official Website.

All of these components must be installed to ensure Kdeps functions as intended.

Note: Using the --latest flag allows you to fetch the latest versions of the schema, Anaconda package, and PKL binary from GitHub and the web. While setting the GITHUB_TOKEN environment variable is optional, it is highly recommended. Without the token, the process will rely on unauthenticated access, which is subject to low rate limits and may result in errors due to rate limit exhaustion.

Kdeps CLI Installation Guide

macOS

For macOS users, the simplest way to install Kdeps is via brew:

brew install kdeps/tap/kdeps

Windows, Linux, and macOS

On macOS, Linux, or Windows, you can use curl to install Kdeps:

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

Alternatively, you can use wget:

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

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

---

Troubleshooting

'Permission Denied' Error During Installation

Issue:

You may encounter a 'Permission Denied' error during installation. This typically occurs when the installer lacks permission to write the Kdeps binary to the ~/.local/bin directory.

Solution:

To fix this, grant the necessary write permissions by running the installation command with sudo:

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

This ensures the installer has the required access to complete the setup successfully.