Quickstart

Quickstart

Get the AP2 reference samples running on your machine in minutes.

Prerequisites

Ensure you have the following installed:

• Python 3.10+
• uv (highly recommended for dependency management)
• Go 1.21+ (if running Go samples)
• Android Studio (if running Android samples)

1. Setup Authentication

AP2 samples use Gemini models for agent reasoning. You need either a Google API Key or Vertex AI configured.

Option 1: Google API Key (Recommended)

1. Get a key from Google AI Studio.
2. Set it in your terminal:

   export GOOGLE_API_KEY='your_key_here'

Option 2: Vertex AI

If you prefer using Google Cloud Vertex AI:

export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT='your-project-id'
gcloud auth application-default login

2. Run the Python Card Sample

The fastest way to see AP2 in action is the Python “Human Present” card scenario.

1. Clone and navigate to the repo:

   git clone https://github.com/google-agentic-commerce/AP2.git
   cd AP2

2. Run the automated script:

   bash samples/python/scenarios/a2a/human-present/cards/run.sh

3. Start Shopping: Open your browser to http://localhost:8000/dev-ui.

   • Select shopping_agent from the dropdown.
   • Type: "I want to buy a pair of red shoes."

3. Explore Other Scenarios

Once you have the basics working, try these other tutorials:

• Android DPC: See how AP2 integrates with Android’s Credential Manager.
• Go Backend Agents: Explore high-performance agent implementations.
• x402 Crypto Payments: Secure digital currency transactions.

Next Steps

• Read the Core Concepts to understand the protocol architecture.
• Deep dive into the Protocol Specification.