Metadata-Version: 2.4
Name: aiagenthub-cli
Version: 0.1.0
Summary: CLI tool for running and managing AI Agents
Home-page: https://github.com/aymanazzam/aiagent-hub
Author: AI Agent Hub Team
Author-email: aymanazzam63@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/aymanazzam/aiagent-hub/issues
Project-URL: Documentation, https://github.com/aymanazzam/aiagent-hub
Project-URL: Source Code, https://github.com/aymanazzam/aiagent-hub
Keywords: ai agents cli registry docker-hub automation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: jsonschema>=4.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: questionary>=2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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

```bash
pip install aiagent
```

## Quick Start

### 1. Login to Registry

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

```bash
aiagent login YOUR_API_KEY
```

### 2. Pull an Agent

Download an agent from the registry:

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

### 3. Run an Agent

Execute an agent locally:

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

### 4. Push Your Agent

Publish your agent to the registry:

```bash
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

```bash
# 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

```bash
# 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
