---
description: "Conventions for using Pydantic models and settings"
globs:
  - "**/*.py"
alwaysApply: false
---

# Pydantic Rules
- Use `pydantic.BaseModel` for request/response schemas.
- For configuration, use `pydantic_settings.BaseSettings` (v2).
- Always provide default values or use `...` for required fields.
- Use model validators (`@field_validator`, `@model_validator`) instead of custom init logic.
- Keep models small and focused on one purpose.