# ImportError: email-validator is not installed, run `pip install pydantic[email]`

- **ID:** `python/fastapi-email-validator-missing`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

A model uses pydantic EmailStr but the optional email-validator dependency is not installed.

## Version Compatibility

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

## Workarounds

1. **** (95% success)
   ```
   Install the extra:
pip install 'pydantic[email]'
   ```
2. **** (90% success)
   ```
   Add email-validator to requirements and rebuild the image.
   ```

## Dead Ends

- **** — Removes validation; invalid emails pass through. (60% fail)
- **** — Base pydantic does not bundle email-validator. (85% fail)