🚀 Python ADK (Agent Development Kit)

A modern, visually rich, GitHub‑ready README to help you set up and use the Python ADK for building Gemini-powered AI agents.

---

🌟 Features

• ⚡ Quickstart-friendly
• 🎨 Visual diagrams & icons
• 🤖 Agent creation made simple
• 🌐 Optional Web UI
• 📦 Clean folder structure overview

---

📌 Table of Contents

• Prerequisites
• Create Virtual Environment
• Install ADK
• Create Your First Agent
• Run Your Agent
• Web UI
• Project Structure
• Troubleshooting
• Learn More

---

🎯 Prerequisites

Requirement	Version
🐍 Python	3.10+
🌐 Internet	Required
🔑 Google API Key	From Google AI Studio

👉 Get API Key: https://aistudio.google.com/apikey

---

📁 1. Create & Activate Virtual Environment

🔨 Create environment

python -m venv <env_name>

⚡ Activate (Windows PowerShell)

<env_name>/Scripts/activate

⚠️ PowerShell Execution Policy Error?

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Then activate again.

---

📦 2. Install ADK

pip install google-adk

---

🤖 3. Create Your First Agent

Option A — ADK CLI

adk create <agent_name>

🧭 4. Agent Creation Flow

Choose a model for the root agent:
1. gemini-2.5-flash
2. Other models
Choose model (1, 2): 1

Enter Google API key: <your_api_key>

🎉 Your Agent Is Ready!

---

🧠 5. Run Your Agent

adk run <agent_name>

🎉 Your Agent Is Ready!

🌐 6. (Optional) Use the Web UI

adk web --port 8000

Open browser:

👉 http://localhost:8000

---

📚 7. Visual Project Overview

📦 my_agent
│
├── 🧠 agent.py        → Your agent logic
├── 🔐 .env             → Contains GOOGLE_API_KEY
└── 📄 __init__.py      → Package marker

---

❓ Troubleshooting

Issue	Fix
🔴 Script blocked in PowerShell	Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
🔴 API key not found	Ensure .env contains GOOGLE_API_KEY=your_key
🔴 Module not found	Activate virtual environment
🔴 Cannot install google-adk	pip install --upgrade pip

---

📘 Learn More

📖 Full docs & examples: 👉 https://google.github.io/adk-docs/#learn-more

---