Skip to content

2. Setup Your Environment

Prerequisites

  • Python 3.10 or higher.
  • Access to a terminal or command prompt.
  • Git, for cloning the repository.
  • A code editor (e.g., Visual Studio Code) is recommended.

Clone the Repository

If you haven't already, clone the A2A Samples repository:

git clone https://github.com/a2aproject/a2a-samples.git -b main --depth 1
cd a2a-samples

Python Environment & SDK Installation

We recommend using a virtual environment for Python projects. The A2A Python SDK uses uv for dependency management, but you can use pip with venv as well.

  1. Create and activate a virtual environment:

    Using venv (standard library):

    python -m venv .venv
source .venv/bin/activate

    python -m venv .venv
.venv\Scripts\activate

  2. Install needed Python dependencies along with the A2A SDK and its dependencies:

    pip install -r samples/python/requirements.txt

Verify Installation

After installation, you should be able to import the a2a package in a Python interpreter:

python -c "import a2a; print('A2A SDK imported successfully')"

If this command runs without error and prints the success message, your environment is set up correctly.