Skip to main content
This guide explains how to set up and launch the Agent Platform CLI to execute different agentic workflows, including building, publishing, and running agents.

​
Prerequisites

Before starting, make sure you have the following installed:
RequirementCommand
Gitgit --version
AWS CLI v2aws --version
uvuv --version
Access to AWS accountN/A

​
Step 1: Clone the repository

First, clone the hdaemon repository which contains the AgP CLI. 
git clone https://github.com/hcompai/hdaemon.git
cd hdaemon

​
Step 2: Create your AWS SSO profile

First, enter the following command to being the process of configuring your AWS SSO profile. 
aws configure sso
When prompted, use the following values (or modify them based on your needs):
PromptValue
SSO session nameshared-dev
SSO start URLhttps://hcompany.awsapps.com/start
SSO regionus-east-2
AWS accountshared-dev
RoleDevShared
Default client regionus-east-2
Output formatjson
Profile nameshared-dev
Go to https://hcompany.awsapps.com/start to retrieve access credentials, like the SSO region, which may vary depending on the AWS account.

​
Step 3: Verify that you’ve created your AWS SSO profile (Optional)

Run the following command in the terminal to verify that your AWS SSO profile has been successfully created. 
aws configure list-profiles
Upon entering the command, you should see the following in the terminal: 
shared-dev

​
Step 4: Log in via AWS SSO

Run the following command to log in using your assigned AWS account and role. 
aws sso login --profile shared-dev
This will open your browser for authentication.

​
Step 5: Authenticate with CodeArtifact

The project depends on private Python packages hosted in AWS CodeArtifact. Run the following setup script: 
source ./setup-codeartifact.sh --profile shared-dev
You should see output indicating the AWS profile is being used.
⚠️ This step must be repeated when:
  • Opening a new terminal
  • Your AWS SSO session expires

​
Step 6: Install dependencies with uv

Run the following command to create a .venv virtual environment and install all dependencies (including the CLI). 
uv sync

​
Step 7: Activate the virtual environment

Run the following command to activate it. 
source .venv/bin/activate
Your shell prompt should now include: 
(hdaemon)

​
Step 8: Verify the CLI is installed

Run the following command to very that the CLI has been installed and to officially launch it! 
agp --help
Your terminal should display:
  • A help screen
  • A list of available commands

​
Step 9: Export your API key

Running commands requires an H API key, created in Portal-H. Retrieve your key and run: 
export AGP_API_KEY="ENTER YOUR API KEY HERE"

​
Step 10: Use the CLI

Start building, running, and publishing agents, and more. The following command lists available agents on the AgP registry. 
agp agents list