ahirtonlopes GitHub avatar

build-with-ai-curitiba-2026

ahirtonlopes

A workshop repository providing two Jupyter notebooks (Portuguese, Curitiba-themed) for building AI agents from scratch using Google ADK, with step-by-step instructions for beginners.

Stars

10

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-12

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It offers practical, localized notebooks that address real free-tier quota issues, model selection, and includes both single-agent tools/memory and multi-agent orchestration patterns.

Who it is for

  • Portuguese-speaking AI beginners
  • Developers new to Google ADK
  • Workshop or meetup attendees
  • Hobbyists exploring agentic AI

Use cases

  • Creating a custom agent with tool calling and conversation memory
  • Building multi-agent pipelines (sequential, loop, parallel, router)
  • Experimenting with Gemini models using free-tier API keys
  • Learning agent orchestration patterns hands-on

Strengths

  • Step-by-step Colab notebooks requiring no local installation
  • Includes model discovery cell and clear instructions for handling rate limits
  • Covers both basic agent construction and advanced multi-agent workflows
  • Notebooks are localized in Portuguese with real-world examples

Considerations

  • Only supports Google Gemini/ADK ecosystem
  • Notebooks are in Portuguese, limiting non-Portuguese speakers
  • Dependent on Google API key and free-tier quota restrictions

README quick start

🤖 Agent Foundry: Engenharia e Construção de Agentes com Google ADK

Material da palestra e workshop apresentados no Build With AI Curitiba — 12/07/2026 🎉

Se você chegou aqui pelo evento: seja bem-vindo(a)! Este repositório foi montado para você conseguir reproduzir tudo em casa, do zero, mesmo que nunca tenha criado um agente de IA antes.


📦 O que tem neste repositório

ArquivoO que é
ADK_BuildWithAICuritiba_Ahirton.pptxOs slides da palestra (Agentes de IA, casos de uso, MCP, A2A e ADK)
ADK_Agent_Foundry_1.ipynbNotebook 1 — Tools & Memory: seu primeiro agente, ferramentas customizadas e memória de conversa
ADK_Agent_Foundry_2.ipynbNotebook 2 — MultiAgents: orquestração de times de agentes (Sequential, Loop, Parallel e Router)

▶️ Abrir direto no Google Colab (não precisa instalar nada na sua máquina):

  • Notebook 1 — Tools & Memory
  • Notebook 2 — MultiAgents

🚀 Comece por aqui (passo a passo para iniciantes)

O material do workshop são os dois notebooks deste repositório — feitos em PT-BR, com exemplos ambientados em Curitiba e já preparados para os modelos Gemini atuais e para os limites do tier gratuito. Siga na ordem: Notebook 1 e depois Notebook 2.

1. Gere sua API key do Google AI Studio

  1. Acesse https://aistudio.google.com/app/apikey com sua conta Google.
  2. Clique em "Create API key" e copie a chave (os formatos atuais começam com AIza... ou AQ...).

2. Abra o Notebook 1 no Colab

Use o botão "Open in Colab" lá em cima — não precisa instalar nada na sua máquina. Depois salve uma cópia sua: Arquivo → Salvar uma cópia no Drive.

3. Guarde a chave no Colab

  1. No menu lateral esquerdo do Colab, clique no ícone de chave (🔑 Secrets).
  2. Crie um secret chamado GOOGLE_API_KEY, cole sua chave e habilite o acesso do notebook.

4. Rode as células na ordem

Execute célula por célula (Shift+Enter). Uma das primeiras células lista todos os modelos Gemini disponíveis para a sua chave e os recursos de cada um — vale a pena olhar antes de seguir. Terminou o Notebook 1? Siga para o Notebook

Description

Workshop Agent Foundry (Build With AI Curitiba 2026): notebooks em PT-BR para construir agentes e times multiagentes com Google ADK + Gemini, com exemplos ambientados em Curitiba. Inclui os slides da palestra.

Related repositories

Similar projects matched by category, topics, and programming language.

qiskit-community
qiskit-community GitHub avatar

qgss-2026

A repository hosting graded exercises (labs) for the Qiskit Global Summer School 2026, with new labs added via releases.

Jupyter Notebook
232
mate-matt
mate-matt GitHub avatar

rag-memory-lab

A hands-on tutorial project that teaches core local RAG retrieval concepts by running Jupyter notebooks without external API keys.

Jupyter Notebook
32
harinishri2204-cpu
harinishri2204-cpu GitHub avatar

Pollu-Sence

PolluSense is an AI-driven platform that monitors and forecasts air pollution by identifying sources and predicting Air Quality Index (AQI) levels using machine learning and deep learning with real-time data.

AI & Machine LearningCloud & DevOps
24