ADK Made Simple - Agent Examples

This project demonstrates simple agents built using the Google Agent Development Kit (ADK). It accompanies the YouTube tutorial series "ADK Made Simple" hosted on the AIOriented YouTube channel.

Full series playlist: ADK Made Simple Playlist

Lessons

Lesson	Link	Description
1	Lesson 1: Basics of ADK & Reddit Scout Agent	Basics of ADK, Building a Reddit news agent with PRAW
2	Lesson 2: Multi-Agent Systems & TTS	Combining ADK with MCP, Multi-Agent Systems, Text-To-Speech with ElevenLabs, LiteLLM

Agents

Reddit Scout: Simulates fetching recent discussion titles from game development subreddits.

General Setup

Clone the repository:

git clone https://github.com/chongdashu/adk-made-simple
cd adk-made-simple

Create and activate a virtual environment (Recommended):

python -m venv .venv
# On Windows
.\.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

Install general dependencies:
```
pip install -r requirements.txt
```
Agent-Specific Setup: Navigate to the specific agent's directory within agents/ and follow the instructions in its README.md (or follow the steps below for the default agent).

Setup & Running Agents

Navigate to Agent Directory:
```
cd agents/reddit_scout
```
Set up API Key:
- Copy the example environment file:
```
cp ../.env.example .env
```
- Edit the .env file and add your Google AI API Key. You can obtain one from Google AI Studio.
```
GOOGLE_API_KEY=YOUR_API_KEY_HERE
```
- Note: You might need to load this into your environment depending on your OS and shell (source .env or similar) if python-dotenv doesn't automatically pick it up when running adk.
Run the Agent:
- Make sure your virtual environment (from the root directory) is activated.
- From the agents/reddit_scout directory, run the agent using the ADK CLI, specifying the core code package:
```
adk run reddit_scout
```
- Alternatively, from the project root (adk-made-simple), you might be able to run:
```
adk run agents/reddit_scout
```
  (Check ADK documentation for preferred discovery method)
- Asynchronous agents can only be run from the web view, so first cd into the agents directory and run
```
adk web
```
  (Check ADK documentation for preferred discovery method)
Interact: The agent will start, and you can interact with it in the terminal. Try prompts like:
- What's the latest news?
- Give me news from unrealengine

Project Structure Overview

adk-made-simple/
├── agents/
│   ├── reddit_scout/        # Lesson 1: Reddit Scout Agent
│   │   ├── __init__.py
│   │   └── agent.py
│   ├── async_reddit_scout/  # Lesson 2: Asynchronous Reddit Scout Agent
│   │   ├── __init__.py
│   │   └── agent.py
│   ├── summarizer/          # Lesson 2: Newscaster Summarizer Agent
│   │   ├── __init__.py
│   │   └── agent.py
│   ├── speaker/             # Lesson 2: Speaker Agent
│   │   ├── __init__.py
│   │   └── agent.py
│   └── coordinator/         # Lesson 2: Coordinator Agent combining sub-agents
│       ├── __init__.py
│       └── agent.py
├── .env.example             # Environment variables example
├── .gitignore               # Root gitignore file
├── requirements.txt         # Project dependencies
├── README.md                # This file (Overall Project README)
└── PLAN.md                  # Development plan notes

LogicaldataCo/adk-made-simple

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages