🚀 Getting Started

This guide quickly walks you through setting up your first agent project.

Want zero setup? 👉 Try in Firebase Studio or in Cloud Shell

Prerequisites

Python 3.10+ (or Go 1.21+ for Go templates) | Google Cloud SDK Install Guide | Terraform Install Guide | uv (Recommended) Install Guide

1. Create Your Agent Project

⚡ uvx (Recommended)

# Single command - no install needed
uvx agent-starter-pack create

pip

# Create and activate a virtual environment
# On Windows use: .venv\Scripts\activate
python -m venv .venv && source .venv/bin/activate

# Install and run
pip install agent-starter-pack
agent-starter-pack create

2. Run Locally

cd <your-project> && make install && make playground

Next Steps

See the Development Guide for the full workflow, or jump to:

• Data Ingestion - Add RAG capabilities
• Deployment Guide - Deploy to Google Cloud
• Observability - Monitor your agent

---

Command Cheatsheet

Quick reference for all available commands.

Project Setup

Command	What It Does
uvx agent-starter-pack create	Scaffold a production-ready AI agent in seconds (Python/Go/TypeScript/Java)
uvx agent-starter-pack enhance	Add CI/CD pipelines and Terraform infrastructure to existing projects
uvx agent-starter-pack setup-cicd	One-command setup of entire CI/CD pipeline + infrastructure

Development Workflow

Command	What It Does
make install	Install all dependencies
make playground	Launch interactive local playground with live reload
make lint	Run code quality checks
make test	Run unit + integration tests

Deployment

Command	What It Does
make deploy	Deploy your agent to Google Cloud (Agent Engine or Cloud Run) in one command
make setup-dev-env	Provision infrastructure using Terraform
make register-gemini-enterprise	Integrate with Gemini Enterprise - make your agent available to your org

Maintenance & Sharing

Command	What It Does
uvx agent-starter-pack upgrade	Auto-upgrade to latest version while preserving your customizations
uvx agent-starter-pack extract	Extract a minimal, shareable agent from your project
uvx agent-starter-pack list	Browse available templates

See Agent Templates Overview for all available templates.