cargo-adk

Scaffolding, build, and deployment CLI for ADK-Rust — generate agent projects from composable templates, verify builds, and deploy to ADK Platform.

Install

cargo install cargo-adk

Commands

cargo adk new — Scaffold a new agent

# Create a basic Gemini agent
cargo adk new my-agent

# Create with a specific template
cargo adk new my-agent --template tools      # custom tools with #[tool] macro
cargo adk new my-agent --template rag        # RAG with vector search
cargo adk new my-agent --template api        # REST API server
cargo adk new my-agent --template openai     # OpenAI-powered agent
cargo adk new my-agent --template a2a        # A2A protocol server
cargo adk new my-agent --template graph      # Graph-based workflow
cargo adk new my-agent --template realtime   # Real-time voice/audio agent

# Compose with addons
cargo adk new my-agent --template tools --addon telemetry --addon auth

# Use an enterprise pattern
cargo adk new my-agent --pattern microservices

# Use a different provider
cargo adk new my-agent --provider anthropic
cargo adk new my-agent --provider openai

# List available templates
cargo adk templates

cargo adk build — Compile without deploying

Verify that your agent project compiles correctly without deploying. Useful for local development and CI pipelines.

# Build in release mode (default)
cargo adk build

# Build in debug mode for faster iteration
cargo adk build --debug

# Build a project at a specific path
cargo adk build --manifest-path /path/to/my-agent/Cargo.toml

Options

Build vs Deploy

cargo adk deploy — Deploy to ADK Platform

# Deploy to local platform (default)
cargo adk deploy

# Deploy to a specific environment and server
cargo adk deploy --environment staging --server https://platform.example.com

# Use a specific auth token
cargo adk deploy --token my-deploy-token

# Skip build (use existing binary)
cargo adk deploy --skip-build

# Validate without pushing (CI-friendly)
cargo adk deploy --dry-run

Options

Authentication

The deploy command authenticates in this order:

1. --token flag (highest priority)
2. ADK_DEPLOY_TOKEN environment variable
3. Cached credentials from ~/.config/adk-deploy/config.json
4. Ephemeral login (requires ADK_DEPLOY_EMAIL env var)

Secret Upload

If your adk-deploy.toml declares secrets and a .env file exists, the CLI automatically uploads matching secrets before pushing:

# adk-deploy.toml
[[secrets]]
key = "google-api-key"
required = true

# .env
GOOGLE_API_KEY=your-actual-key

The convention maps UPPER_SNAKE_CASE env var names to lower-kebab-case secret keys:

• GOOGLE_API_KEY → google-api-key
• OPENAI_API_KEY → openai-api-key
• DATABASE_URL → database-url

Deploy Flow

1. Load and validate adk-deploy.toml
2. Authenticate with the platform
3. Upload secrets from .env (if present)
4. Build the release binary
5. Create a .tar.gz bundle (manifest + binary)
6. Compute SHA-256 checksum
7. Push to the platform server

Templates

Each template generates:

• Cargo.toml with the right dependencies and feature flags
• src/main.rs that compiles and runs immediately
• .env.example with the required API key variables
• README.md with setup instructions

Composable Template System

The --addon flag lets you layer cross-cutting capabilities onto any base template:

# Add telemetry and auth to a tools agent
cargo adk new my-agent --template tools --addon telemetry --addon auth

# Add Docker and CI to an API server
cargo adk new my-agent --template api --addon docker --addon ci

# Combine multiple addons
cargo adk new my-agent --template a2a --addon telemetry --addon monitoring --addon docker

Available Addons (9)

Enterprise Patterns (5)

Pre-composed combinations of a base template and curated addons for production scenarios:

# Use an enterprise pattern
cargo adk new my-service --pattern microservices

# Extend a pattern with additional addons
cargo adk new my-service --pattern microservices --addon auth

For full documentation on all templates, addons, and patterns, see the Composable Templates Guide.

Generated Project

my-agent/
├── Cargo.toml
├── src/
│   └── main.rs
├── .env.example
├── README.md
└── .gitignore

cd my-agent
cp .env.example .env    # add your API key
cargo run               # interactive console
cargo adk build         # verify compilation
cargo adk deploy        # push to platform

Version

Current version: 0.9.0

[dependencies]
cargo-adk = "0.9.0"

Part of ADK-Rust

This tool is part of the ADK-Rust framework for building AI agents in Rust.

License

Apache-2.0