test-adk/README.md

ADK Sample Project

Public example using Google ADK with a simple email pipeline.

Requirements

• Python 3.13, uv (pip install uv or see https://astral.sh/uv)

Setup

1. Install deps:

uv sync

2. Create .env in project root:

GEMINI_API_KEY=your_key
GENAI_MODEL=gemini-2.5-flash

Run

uv run uvicorn main:app --reload

Web UI at http://localhost:8000.

API

POST http://localhost:8000/process_data

curl -s -X POST http://localhost:8000/process_data \
  -H 'Content-Type: application/json' \
  -d '{"message":"Draft an email about Friday meeting at 2pm"}'

Returns { "emails": "..." }.

Stateless mode

• Sessions are ephemeral and in-memory only; no SQLite persistence.
• Each request creates a new session and it is deleted after completion.
• Web UI works, but conversation history resets on refresh/restart.