https://github.com/astrodevil/adk-agent-examples
Examples of agent apps built with different tools — powered by Google's Agent Development Kit (ADK) and Nebius AI.
https://github.com/astrodevil/adk-agent-examples
Last synced: 7 months ago
JSON representation
Examples of agent apps built with different tools — powered by Google's Agent Development Kit (ADK) and Nebius AI.
- Host: GitHub
- URL: https://github.com/astrodevil/adk-agent-examples
- Owner: Astrodevil
- License: mit
- Created: 2025-04-19T16:38:50.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-06-05T09:34:30.000Z (7 months ago)
- Last Synced: 2025-06-22T06:53:41.031Z (7 months ago)
- Language: Jupyter Notebook
- Homepage:
- Size: 84 KB
- Stars: 15
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ADK Agent Examples
Full explainer video is available on YouTube - [Analyzer Agent + ADK Intro](https://www.youtube.com/watch?v=FYhKah8FpAg), [Job Finder Agent(MistralOCR + Qwen3)](https://youtu.be/ji_hECcyTjs?si=l25jghg1wAgIc8_1). Read detailed [blog 1](https://dev.to/astrodevil/i-built-a-team-of-5-agents-using-google-adk-meta-llama-and-nemotron-ultra-253b-ec3) and [blog 2](https://medium.com/data-science-collective/i-tested-deepseek-r1-0528-built-a-job-finding-agent-with-adk-nebius-ai-linkup-76e6e62bdbba?sk=fa84bd0038671f6988e58368e14f2233)
This repository contains various agent demos built with Google's [ADK (Agent Development Kit)](https://google.github.io/adk-docs/), showcasing different patterns and capabilities for building AI agents. ADK is a flexible and modular framework that makes agent development feel more like software development. While optimized for Gemini and the Google ecosystem, it's model-agnostic, deployment-agnostic, and compatible with other frameworks. ADK enables developers to create, deploy, and orchestrate agentic architectures ranging from simple tasks to complex workflows, with features like multi-agent pipelines, tool integration, and sequential processing.
## LLM Integration
All demos in this repository are powered by [Nebius AI](https://dub.sh/AIStudio) using open-source LLMs:
- **Meta-Llama-3.1-8B-Instruct** - Used in most agent implementations
- **Llama-3_1-Nemotron-Ultra-253B** - Used for advanced analysis in the Analyzer Agent
- **Qwen3-14B** - Used for Job Finder Agent
These models are integrated via [LiteLLM](https://github.com/BerriAI/litellm), which ADK supports for connecting to various model providers.
## Agent Demos
| Agent | Pattern | Description | Details |
|-------|---------|-------------|---------|
| [Analyzer Agent](./analyzer_agent/) | 5-agent sequential pipeline | AI trends analysis with multiple data sources | [README](./analyzer_agent/README.md) |
| [Email Agent](./email_adk_agent/) | Single agent with tool | Email integration with Resend API | [README](./email_adk_agent/README.md) |
| [Sequential Agent](./seq_adk_agent/) | 3-agent sequential pipeline | News aggregator combining IPL and AI news | [README](./seq_adk_agent/README.md) |
| [Multi-Tool Search](./multi_tool_search_agent/) | Root agent with delegation | Modular search with agent delegation | [README](./multi_tool_search_agent/README.md) |
| [Job Finder](./jobfinder_agent/) | 4-agent sequential pipeline | Resume analysis and job matching | [README](./jobfinder_agent/README.md) |
For detailed information about each agent, please refer to the individual READMEs in their respective directories.
## Implementation Patterns Demonstrated
This repository demonstrates several important ADK patterns:
1. **Sequential Agent Chaining** - Multiple agents executing in sequence, with outputs becoming inputs for the next agent.
2. **Tool Integration** - Using external APIs and services as tools within agents.
3. **Agent Delegation** - A root agent delegating tasks to specialized sub-agents.
4. **Multi-Model Approach** - Using different LLM models for different tasks based on capabilities.
5. **Specialized Agents** - Agents designed for specific tasks like search, summary, analysis, etc.
## Setup
1. Clone the repository:
```bash
git clone https://github.com/Astrodevil/ADK-Agent-Examples.git
cd ADK-Agent-Examples
```
2. Install ADK:
```bash
pip install google-adk
```
3. Create and activate a virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
4. Install dependencies:
```bash
pip install -r requirements.txt
```
5. Set up your environment variables for the agent you want to run:
```bash
# Example for analyzer agent
cp analyzer_agent/.env.example analyzer_agent/.env
```
Then edit the `.env` file to include your API keys.
## Usage
### Running Agents with ADK CLI
```bash
# Dev UI - Visual interface for testing and debugging agents
adk web
# Terminal - Run agents directly in the terminal
adk run analyzer_agent
adk run email_adk_agent
adk run seq_adk_agent
adk run multi_tool_search_agent
adk run jobfinder_agent
# API Server - Create a local FastAPI server for API testing
adk api_server
```
### API Keys Required
You'll need to set up accounts and obtain API keys for:
| Service | Purpose | Required For |
|---------|---------|--------------|
| [Nebius AI](https://dub.sh/AIStudio) | LLM inference | All agents |
| [Exa](https://exa.ai/) | Web search | Most agents |
| [Tavily](https://tavily.com/) | Specialized search | Some agents |
| [Firecrawl](https://firecrawl.dev/) | Web scraping | Analyzer agent |
| [Resend](https://resend.com/) | Email sending | Email agent |
| [Mistral AI](https://mistral.ai) | OCR processing | Job Finder agent |
| [Linkup](https://www.linkup.so/) | Job search | Job Finder agent |
See each agent's README for specific requirements.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.