AI Agent Hub CLI

Command-line interface for managing and running AI Agents from the AI Agent Hub registry.

Features

• 🚀 Pull & Run: Download and execute agents from the registry
• 📦 Push: Publish your agents to the registry
• 🏷️ Version Management: Tag and manage agent versions
• 🔑 Authentication: Secure API key-based authentication
• 🔄 Background Execution: Run agents as background processes
• ✅ Validation: Verify agent specifications before deployment

Installation

pip install aiagent

Quick Start

1. Login to Registry

First, create an API key in your AI Agent Hub profile, then login:

aiagent login YOUR_API_KEY

2. Pull an Agent

Download an agent from the registry:

aiagent pull username/agent-name
aiagent pull username/agent-name:1.0.0

3. Run an Agent

Execute an agent locally:

aiagent run ./agent-name
aiagent run -d ./agent-name  # Run in background

4. Push Your Agent

Publish your agent to the registry:

aiagent push ./my-agent
aiagent push ./my-agent -t latest

Commands

Authentication

• aiagent login <api-key> - Login to the registry
• aiagent logout - Logout from the registry
• aiagent whoami - Show current logged-in user
• aiagent register - Create a new account

Agent Management

• aiagent pull <name> - Download an agent
• aiagent push <path> - Upload an agent
• aiagent run <path> - Execute an agent
• aiagent validate <path> - Verify agent specification
• aiagent list - Browse available agents
• aiagent versions <name> - Show all versions of an agent

Version Control

• aiagent tag <name:version> <tag> - Tag a version

Process Management

• aiagent ps - List running agents
• aiagent stop <id> - Stop a running agent
• aiagent logs <id> - View agent logs

API Keys

• aiagent key create <name> - Create a new API key
• aiagent key list - List your API keys
• aiagent key revoke <id> - Revoke an API key

Examples

Publishing an Agent

# Validate your agent
aiagent validate ./my-agent

# Create agent in registry (first time)
aiagent push ./my-agent --create --description "My awesome agent"

# Tag as latest
aiagent tag my-agent:1.0.0 latest

Running Agents in Background

# Start agent in background
aiagent run -d ./my-agent

# Check running agents
aiagent ps

# Stop an agent
aiagent stop <agent-id>

Requirements

• Python 3.9 or higher

License

MIT

Links

• Documentation: https://github.com/yourusername/aiagent-hub
• Issue Tracker: https://github.com/yourusername/aiagent-hub/issues