For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Install agentregistry in a Kubernetes cluster by using the Helm package manager.

Agentregistry is an open source, centralized AI artifact catalog that helps you build, package, publish, and discover AI artifacts, including agents, skills, MCP servers, prompts, and plugins. It provides a single source of truth for the AI building blocks your teams share and deploy.

Before you begin

1. Install the following CLIs:
   • kubectl
   • Helm v3 or later
2. Create or use an existing Kubernetes cluster. For local test setup, you can use Kind.

   kind create cluster

Install agentregistry

The agentregistry Helm chart includes a bundled PostgreSQL instance for development and evaluation. For production, bring your own PostgreSQL instance instead.

1. Install agentregistry with the bundled PostgreSQL instance.

   helm upgrade -i agentregistry oci://ghcr.io/agentregistry-dev/agentregistry/charts/agentregistry \
       --namespace agentregistry \
       --create-namespace

   Note

   The bundled PostgreSQL instance is for development and evaluation only. Data is lost if the PostgreSQL pod is restarted or rescheduled. For production, use an external PostgreSQL instance instead.

2. Verify that the agentregistry and PostgreSQL pods are up and running.

   kubectl get pods -n agentregistry

   Example output:

   NAME                                       READY   STATUS    RESTARTS   AGE
   agentregistry-c46b8bd98-hvnzf              1/1     Running   0          45s
   agentregistry-postgresql-9858cbcbf-tk7p9   1/1     Running   0          45s
   

3. Port-forward the agentregistry service to access the UI and API from your local machine.

   kubectl port-forward -n agentregistry svc/agentregistry 12121:12121

4. Optional: To connect AI development tools to the registry MCP server, port-forward the MCP port in a separate terminal. For more information, see Connect AI clients to the registry MCP server.

   kubectl port-forward -n agentregistry svc/agentregistry 31313:31313

5. Open the agentregistry UI in your browser.

   

   

Install the arctl CLI

1. Install the arctl binary on your local machine to manage agentregistry resources.

   curl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/get-arctl | bash
   
   export PATH="/usr/local/bin:$PATH"

2. Verify that the CLI is installed correctly.

   arctl version

Next steps

With agentregistry up and running, start adding AI artifacts to build out your AI artifact catalog.