Google ADK Development Environment

This project is set up with a development container optimized for Google Agent Development Kit (ADK) development using Python 3.13.

🚀 Quick Start

1. Prerequisites: Make sure you have VS Code with the Dev Containers extension installed

2. Open in Dev Container: Open this folder in VS Code and click "Reopen in Container" when prompted

3. Wait for Setup: The container will build and install all dependencies automatically

4. Start Developing: You're ready to build Google ADK applications!

📦 What's Included

Development Environment

• Python 3.13 - Latest Python version
• VS Code Extensions - Python, Pylint, Black, Jupyter, Google Cloud Code, and more
• Google Cloud SDK - Pre-installed and ready to use
• Git & GitHub CLI - Version control tools

Python Packages

• Google Cloud Libraries - Storage, BigQuery, AI Platform, Speech, Vision, etc.
• Machine Learning - TensorFlow, PyTorch, Transformers, LangChain
• Web Frameworks - FastAPI, Flask, with async support
• Development Tools - pytest, ruff, black, mypy, pre-commit
• Data Processing - pandas, numpy, matplotlib, plotly

Features

• Port Forwarding - Common development ports (3000, 5000, 8000, 8080, 9000)
• Custom Aliases - Helpful shortcuts for ADK development
• Auto-formatting - Code formatting on save
• Testing Setup - pytest configuration
• Jupyter Support - For interactive development

🔧 Configuration

Google Cloud Setup

1. Copy .env.example to .env and configure your settings

2. Run adk-setup to authenticate with Google Cloud

3. Set your project ID: gcloud config set project YOUR_PROJECT_ID

Useful Commands

• adk-setup - Setup Google Cloud authentication
• adk-test - Run tests
• adk-format - Format code with black and fix with ruff
• adk-lint - Run ruff linter
• adk-check - Run full code quality check (ruff + mypy + pytest)

📁 Project Structure

.devcontainer/
├── devcontainer.json    # Dev container configuration
├── Dockerfile          # Container image definition
└── bashrc              # Custom bash configuration

requirements.txt         # Python dependencies
.env.example            # Environment variables template

🔍 Development Tips

1. Package Management: This setup uses uv for fast Python package installation

2. Code Quality: Pre-commit hooks are automatically installed with ruff, black, and mypy

3. Authentication: Use gcloud auth application-default login for local development

4. Environment Variables: Copy .env.example to .env and customize

5. Testing: Place tests in a tests/ directory and run with adk-test

6. Linting: Use adk-lint for ruff linting or adk-check for comprehensive checks

📚 Additional Resources

• Google Agent Development Kit Documentation
• Google Cloud Python Client Libraries
• VS Code Dev Containers

Happy coding! 🎉