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! 🎉