convez.ai
AgenteDesenvolvimento WebIntermediário
AI-Training-Projects

PydanticAI FastAPI Workshop

AI-Training-Projects/PydanticAI-FastAPI-Workshop

Workshop hands-on: construa agentes IA com Pydantic AI e FastAPI

Ver no GitHub
InicialPluginScore · de 0 a 100

Workshop prático para aprender os fundamentos de Pydantic AI e FastAPI aplicados a aplicações com agentes IA. Inclui projeto real (TaskFlow API) com exercícios progressivos cobrindo skills, agents, MCP servers e gerenciamento de contexto.

Instalação

$npx convez-ai AI-Training-Projects/PydanticAI-FastAPI-Workshop

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Aprender a construir aplicações agenticas com Python
  • Dominar skills, agents e MCP servers do Claude
  • Implementar workflows de automação e guardrails em APIs

Veredito

Workshop estruturado e prático que cobre bem o ecossistema Pydantic AI + FastAPI. Exercícios progressivos e projeto real (TaskFlow API) tornam o aprendizado concreto; ideal para devs Python que querem entrar em arquiteturas agenticas.

README

A tradução para o português deste README ainda está na fila.

Claude Code Workshop

A hands-on workshop to learn Claude Code from beginner to intermediate, built around a real Python FastAPI project.

What You'll Learn

#ExerciseTopic
1Getting StartedLaunch, explore, make changes
2CLAUDE.mdProject instructions & context
3Settings & PermissionsConfigure behavior & access control
4HooksAutomation & guardrails
5SkillsCustom slash commands
6AgentsSpecialized subagents
7MCP ServersExternal integrations
8Context ManagementManaging context & tool usage
9Real-World WorkflowPutting it all together

Prerequisites

  • Python 3.11+
  • uv installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
  • Claude Code installed and authenticated
  • A terminal (macOS, Linux, or WSL on Windows)

Quick Start

# Clone the repo
git clone https://github.com/zachschillaci27/claude-code-workshop.git
cd claude-code-workshop

# Install dependencies
uv sync

# Verify setup
uv run pytest

# Start the workshop!
claude

The Demo Project: TaskFlow API

A task management REST API built with FastAPI. It's simple enough to understand in minutes, but has enough surface area to demonstrate all Claude Code features.

Run the API

uv run uvicorn taskflow.main:app --reload
# Open http://localhost:8000/docs for interactive API docs

Run Tests

uv run pytest                                          # all tests
uv run pytest tests/test_tasks.py -v                   # task tests only
uv run pytest tests/test_tasks.py::test_create_task -v # single test

Project Structure

src/taskflow/
├── main.py              # FastAPI app entry point
├── models.py            # Pydantic request/response models
├── database.py          # In-memory database with seed data
├── utils.py             # Helper functions
└── routers/
    ├── tasks.py         # Task CRUD endpoints
    └── users.py         # User endpoints

tests/
├── conftest.py          # Shared fixtures
├── test_tasks.py        # Task endpoint tests
├── test_models.py       # Model validation tests
└── test_utils.py        # Utility function tests

Claude Code Configuration (included)

CLAUDE.md                          # Project instructions
.claude/
├── settings.json                  # Permissions & hooks
├── hooks/
│   └── block-hardcoded-keys.sh           # Blocks hardcoded secrets
├── skills/
│   ├── review/SKILL.md            # /review - Code review
│   ├── add-endpoint/SKILL.md      # /add-endpoint - Scaffold endpoints
│   └── test-coverage/SKILL.md     # /test-coverage - Coverage analysis
└── agents/
    ├── researcher.md              # Read-only research agent
    └── reviewer.md                # Code review agent
.mcp.json                          # MCP server config (GitHub)

Feature Coverage

This workshop covers the following Claude Code features:

  • CLAUDE.md - Project-level, user-level, and nested instructions
  • Settings - Project, local, and user settings with permission rules
  • Hooks - PreToolUse, PostToolUse, Notification events with shell scripts
  • Skills - Custom slash commands with arguments and dynamic context
  • Agents - Custom subagents with tool restrictions and model selection
  • MCP Servers - External integrations (GitHub example)
  • Built-in tools - Read, Edit, Write, Bash, Grep, Glob
  • Built-in commands - /init, /compact, /memory, /help
  • Permission modes - Allow/deny rules, plan mode (via Shift+Tab cycling)
Ver o original no GitHub

Bom para

Relacionados