Publish a Package

Share your AI agent packages with the world.

Create kdeps.pkg.yaml

Add a manifest file to your project root:

name: my-agent
version: 1.0.0
type: workflow  # workflow | component | agency
description: "A brief description of your package"
author: your-username
license: Apache-2.0
homepage: https://github.com/you/my-agent
repo_url: https://github.com/you/my-agent
tags:
  - ai
  - automation

Verify LLM-agnostic compatibility

Packages must not contain hardcoded API keys or secrets. Run the verifier before publishing:

kdeps registry verify

Use env("OPENAI_API_KEY") or leave fields empty — consumers configure their own keys via ~/.kdeps/config.yaml.

Publish via CLI or API

Use the kdeps CLI (verification runs automatically):

kdeps registry publish

Or publish via API (include the archive file):

curl -X POST https://kdeps.io/api/packages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "manifest=@kdeps.pkg.yaml" \
  -F "readme=@README.md" \
  -F "archive=@package.tar.gz"

API Reference

Method	Endpoint	Description
GET	/api/packages	List all packages
POST	/api/packages	Publish a package (auth required)
GET	/api/packages/:name	Get package details
POST	/api/packages/:name/star	Star a package (auth required)
GET	/api/packages/:name/download/:version	Download a package version
GET	/api/stats	Get registry statistics
GET	/api/keys	List your API keys (auth required)
POST	/api/keys	Create an API key (auth required)
DELETE	/api/keys	Delete an API key (auth required)