This release is a pre-release and may not be stable for production use.
AG2 CLI
A CLI tool for building, running, and deploying A2A-compatible agents.
Installation
pip install ag2-cli
Or install from source:
git clone https://github.com/AG2Platform/ag2-cli.git
cd ag2-cli
pip install -e .
Quick Start
Create a new agent
ag2 init my-agent
cd my-agent
Build and run with Docker
ag2 build
ag2 run
Run natively (without Docker)
ag2 run --native
Register with AgentOS
ag2 auth login
ag2 register https://my-agent.example.com
Commands
Authentication
ag2 auth login # Login to AgentOS
ag2 auth logout # Logout
ag2 auth whoami # Show current user
Agent Development
ag2 init [name] # Create new agent project
ag2 create file.yaml # Create agent from AgentFile
Docker Lifecycle
ag2 build [path] # Build agent Docker image
ag2 run [name] # Run agent in Docker container
ag2 stop <name> # Stop a running container
ag2 restart <name> # Restart a container
ag2 logs <name> # View container logs
ag2 ps # List running containers
ag2 rm <name> # Remove a container
ag2 rmi <name> # Remove an image
ag2 images # List built images
ag2 tag <src> <dst> # Tag an image
Registry
ag2 register <url> # Register running agent with AgentOS
ag2 agents # List your registered agents
ag2 list # List local agent images
A2A Protocol
ag2 call <url> "message" # Call any A2A agent
ag2 card show [path] # Display agent card (from path or Docker image)
ag2 card validate [path] # Validate A2A compliance
Configuration
ag2 configure # Interactive configuration wizard
ag2 config show # Show current configuration
ag2 config set <k> <v> # Set configuration value
AgentFile Format
The agent.yaml file defines your agent:
name: "my-agent"
version: "1.0.0"
description: "My AI agent"
card:
provider: "my-org"
skills:
- name: "default"
description: "Default capability"
auth:
scheme: "bearer"
agent:
model: "gpt-4o"
system_prompt: |
You are a helpful assistant.
build:
python: "3.11"
dependencies:
- requests
deploy:
replicas: 2
memory: "1GB"
A2A Protocol
This CLI generates A2A-compatible agents that implement:
- Agent Card at
/.well-known/a2a/agent-card.json - JSON-RPC 2.0 task endpoints
- SSE streaming support
- Standard authentication schemes
Development
Running tests
make test # Run unit tests
make test-docker # Run Docker lifecycle tests
make test-all # Run all tests
Documentation
make docs-install # Install documentation dependencies
make docs # Start local docs server
make docs-build # Build documentation
License
MIT
Metadata
Release files for ag2-agentos 0.0.0a29
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ag2_agentos-0.0.0a29.tar.gz | 24.5 kB | Without provenance | Details for ag2_agentos-0.0.0a29.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ag2_agentos-0.0.0a29-py3-none-any.whl | Python 3 | none | any | Details for ag2_agentos-0.0.0a29-py3-none-any.whl |
Total release size: 57.1 kB
Release files / ag2_agentos-0.0.0a29.tar.gz
| Download URL | ag2_agentos-0.0.0a29.tar.gz |
|---|---|
| Size | 24.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fd237072d455cf2d216b73a16ef33ae08e26f177eeb64da2f9c571f1a7b14425
|
|
BLAKE2b-256 checksum How to use checksums |
87739e90538b98b15ad41914b5420b2f6188849e0c46ed76af07cef6d8a4b4a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.22
|
Release files / ag2_agentos-0.0.0a29-py3-none-any.whl
| Download URL | ag2_agentos-0.0.0a29-py3-none-any.whl |
|---|---|
| Size | 32.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1a344c4c3884c21a1b47fb4a6841b1f30b8b143ae53d37eaff569ec34974371
|
|
BLAKE2b-256 checksum How to use checksums |
858fd1aa4041f9d77b9546cc8e8ebda72bcb10056736c5827afa2bf779bdcd5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.22
|
Security for ag2-agentos 0.0.0a29
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.