# pydantic.errors.PydanticUserError: `EmailStr` requires the `email-validator` package. Install it with `pip install pydantic[email]`.

- **ID:** `python/pydantic-email-str-deprecated`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

EmailStr is used but the optional email-validator dependency is not installed.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 2.x | active | — | — |

## Workarounds

1. **** (98% success)
   ```
   pip install 'pydantic[email]'
   ```
2. **** (97% success)
   ```
   pip install email-validator
# then
from pydantic import BaseModel, EmailStr
class U(BaseModel):
    email: EmailStr
   ```

## Dead Ends

- **** — Wrong package; 'email' is a stdlib module, not a PyPI validator. (70% fail)
- **** — Loses email format validation; invalid addresses pass through. (55% fail)
- **** — Import still fails until the interpreter restarts. (40% fail)