Breaking Changes

• ➖ Drop support for Pydantic v1. PR #1701 by @tiangolo.

Internal

• ⬆ Bump dirty-equals from 0.9.0 to 0.11. PR #1649 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.7.0 to 9.7.1. PR #1690 by @dependabot[bot].
• ⬆ Bump typer from 0.20.1 to 0.21.0. PR #1694 by @dependabot[bot].
• 📌 Relax prek version pin to >=0.2.24,<1.0.0. PR #1698 by @YuriiMotov.

Breaking Changes

• ➖ Drop support for Python 3.8. PR #1696 by @tiangolo.

Docs

• ➖ Drop support for Python 3.8 in CI and docs. PR #1695 by @tiangolo.

Internal

• 🔧 Update pre-commit, generate select on pre-commit, use local Ruff. PR #1697 by @tiangolo.
• ⬆ Bump actions/checkout from 5 to 6. PR #1692 by @dependabot[bot].
• 👷 Add pre-commit workflow. PR #1684 by @YuriiMotov.
• ✅ Simplify tests for code examples, one test file for multiple variants. PR #1664 by @YuriiMotov.
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1677 by @pre-commit-ci[bot].
• ⬆ Bump actions/download-artifact from 6 to 7. PR #1676 by @dependabot[bot].
• ⬆ Bump actions/cache from 4 to 5. PR #1673 by @dependabot[bot].
• ⬆ Bump markdown-include-variants from 0.0.5 to 0.0.8. PR #1674 by @dependabot[bot].
• ⬆ Bump actions/upload-artifact from 5 to 6. PR #1675 by @dependabot[bot].
• ⬆ Bump mypy from 1.18.2 to 1.19.1. PR #1679 by @dependabot[bot].
• ⬆ Bump typer from 0.20.0 to 0.20.1. PR #1685 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.8 to 0.14.10. PR #1681 by @dependabot[bot].

Fixes

• 🐛 Fix alias support for Pydantic v2. PR #1577 by @ravishan16.

Fixes

• 🐛 Fix RuntimeError: dictionary changed size during iteration in sqlmodel_update(). PR #997 by @BartSchuurmans.

Docs

• 💅 Update CSS to explicitly use emoji font. PR #1658 by @tiangolo.
• 📝 Update link to JetBrains Python survey in features.md. PR #1627 by @sparkiegeek.
• 📝 Fix broken links in docs. PR #1601 by @YuriiMotov.

Internal

• 📌 Pin FastAPI in tests to 0.125.0 while dropping support for Python 3.8. PR #1689 by @tiangolo.
• 👷 Configure coverage, error on main tests, don't wait for Smokeshow. PR #1683 by @YuriiMotov.
• 👷 Run Smokeshow always, even on test failures. PR #1682 by @YuriiMotov.
• ⬆ Bump ruff from 0.14.6 to 0.14.8. PR #1667 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1662 by @pre-commit-ci[bot].
• ⬆ Bump actions/checkout from 5 to 6. PR #1656 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.5 to 0.14.6. PR #1652 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1655 by @pre-commit-ci[bot].
• ⬆ Bump actions/checkout from 5 to 6. PR #1651 by @dependabot[bot].
• 💄 Use font Fira Code to fix display of Rich panels in docs in Windows. PR #1653 by @tiangolo.
• 👷 Upgrade latest-changes GitHub Action and pin actions/checkout@v5. PR #1654 by @svlandeg.
• 🔧 Upgrade Material for MkDocs and remove insiders. PR #1650 by @tiangolo.
• ⬆ Bump mkdocs-material from 9.6.23 to 9.7.0. PR #1645 by @dependabot[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.4.1 to 1.5.0. PR #1647 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.4 to 0.14.5. PR #1646 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1648 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.14.3 to 0.14.4. PR #1640 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1642 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-material from 9.6.22 to 9.6.23. PR #1637 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.2 to 0.14.3. PR #1633 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1636 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.4.0 to 1.4.1. PR #1626 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.1 to 0.14.2. PR #1616 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1625 by @pre-commit-ci[bot].
• 🔧 Add PEP-639 license metadata. PR #1624 by @svlandeg.
• ⬆ Bump griffe-typingdoc from 0.2.9 to 0.3.0. PR #1615 by @dependabot[bot].
• ⬆ Bump actions/upload-artifact from 4 to 5. PR #1620 by @dependabot[bot].
• ⬆ Bump actions/download-artifact from 5 to 6. PR #1621 by @dependabot[bot].
• ⬆ Bump ruff from 0.14.0 to 0.14.1. PR #1614 by @dependabot[bot].
• ⬆ Bump ruff from 0.13.2 to 0.14.0. PR #1592 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1605 by @pre-commit-ci[bot].
• ⬆ Bump astral-sh/setup-uv from 6 to 7. PR #1593 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.21 to 9.6.22. PR #1608 by @dependabot[bot].
• 🔧 Configure reminder for waiting label in issue-manager. PR #1609 by @YuriiMotov.
• ⬆ Bump typer from 0.19.2 to 0.20.0. PR #1612 by @dependabot[bot].
• ✅ Remove unused type ignores since SQLAlchemy 2.0.44. PR #1613 by @svlandeg.

Upgrades

• ⬆️ Add support for Python 3.14. PR #1578 by @svlandeg.

Fixes

• 🐛 Fix attribute handling in model_dump for compatibility with the latest Pydantic versions. PR #1595 by @spazm.

Docs

• 📝 Fix typo in docs/tutorial/fastapi/simple-hero-api.md. PR #1583 by @kofi-kusi.

Internal

• ⬆ Bump mypy from 1.4.1 to 1.18.2. PR #1560 by @dependabot[bot].
• ✅ Add test that runs select with 3 or 4 arguments. PR #1590 by @svlandeg.
• ⬆ Bump mkdocs-macros-plugin from 1.3.9 to 1.4.0. PR #1581 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.20 to 9.6.21. PR #1588 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1584 by @pre-commit-ci[bot].
• ⬆ Bump tiangolo/issue-manager from 0.5.1 to 0.6.0. PR #1589 by @dependabot[bot].
• 👷 Update docs previews comment, single comment, add failure status. PR #1586 by @tiangolo.
• ⬆ Bump markdown-include-variants from 0.0.4 to 0.0.5. PR #1582 by @dependabot[bot].
• ⬆ Bump typing-extensions from 4.13.2 to 4.15.0 for Python 3.9+. PR #1580 by @svlandeg.
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1571 by @pre-commit-ci[bot].
• ⬆ Bump typer from 0.17.4 to 0.19.2. PR #1573 by @dependabot[bot].
• ⬆ Bump ruff from 0.13.0 to 0.13.2. PR #1576 by @dependabot[bot].
• 💚 Fix CI test suite for Windows and MacOS. PR #1307 by @svlandeg.

Features

• ✨ Add overload for exec method to support insert, update, delete statements. PR #1342 by @seriaati.

Upgrades

• ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR #1316 by @svlandeg.

Docs

• ✏️ Fix typos in docs/tutorial/relationship-attributes/cascade-delete-relationships.md. PR #1543 by @YuriiMotov.
• 🍱 Update SVG files, a single file per diagram, sans-serif fonts. PR #1373 by @tiangolo.
• 📝 Grammar tweak in docs/tutorial/insert.md. PR #1368 by @brettcannon.
• 📝 Update docs/tutorial/fastapi/relationships.md. PR #1365 by @Foxerine.
• ✏️ Tweak the grammar in docs/learn/index.md. PR #1363 by @brettcannon.
• 📝 Update all docs references to Optional to use the new syntax in Python 3.10, e.g. int | None. PR #1351 by @tiangolo.
• 📝 Update install and usage with FastAPI CLI in FastAPI tutorial. PR #1350 by @tiangolo.
• 📝 Update FastAPI tutorial docs to use the new model.sqlmodel_update() instead of old setattr(). PR #1117 by @jpizquierdo.
• ✏️ Update docs/virtual-environments.md. PR #1321 by @sylvainHellin.

Internal

• ⬆ Bump griffe-typingdoc from 0.2.8 to 0.2.9. PR #1553 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.17 to 9.6.20. PR #1565 by @dependabot[bot].
• ⬆ Bump actions/setup-python from 5 to 6. PR #1551 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.12 to 0.13.0. PR #1559 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1564 by @pre-commit-ci[bot].
• ⬆ Bump actions/labeler from 5 to 6. PR #1549 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1556 by @pre-commit-ci[bot].
• ⬆ Bump typer from 0.17.3 to 0.17.4. PR #1554 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1546 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.12.10 to 0.12.12. PR #1548 by @dependabot[bot].
• ⬆ Bump typer from 0.16.1 to 0.17.3. PR #1547 by @dependabot[bot].
• ⬆ Bump pypa/gh-action-pypi-publish from 1.12.4 to 1.13.0. PR #1550 by @dependabot[bot].
• 👷 Detect and label merge conflicts on PRs automatically. PR #1552 by @svlandeg.
• ⬆ Bump ruff from 0.12.9 to 0.12.10. PR #1532 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1534 by @pre-commit-ci[bot].
• ⬆ Bump typer from 0.16.0 to 0.16.1. PR #1531 by @dependabot[bot].
• ⬆ Bump actions/download-artifact from 4 to 5. PR #1451 by @dependabot[bot].
• ⬆ Bump actions/checkout from 4 to 5. PR #1488 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1479 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-macros-plugin from 1.3.7 to 1.3.9. PR #1507 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.7 to 0.12.9. PR #1521 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.16 to 9.6.17. PR #1528 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1444 by @pre-commit-ci[bot].
• ⬆ Bump mkdocs-material from 9.6.15 to 9.6.16. PR #1446 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.4 to 0.12.7. PR #1447 by @dependabot[bot].
• ⬆ Bump tiangolo/latest-changes from 0.3.2 to 0.4.0. PR #1448 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1437 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.12.3 to 0.12.4. PR #1436 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1428 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.12.2 to 0.12.3. PR #1432 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1418 by @pre-commit-ci[bot].
• ⬆ Bump pillow from 11.2.1 to 11.3.0. PR #1423 by @dependabot[bot].
• ⬆ Bump mkdocs-material from 9.6.14 to 9.6.15. PR #1424 by @dependabot[bot].
• ⬆ Bump ruff from 0.12.0 to 0.12.2. PR #1425 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1374 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.11.13 to 0.12.0. PR #1403 by @dependabot[bot].
• ✅ Simplify tests for tests/test_tutorial/test_code_structure/test_tutorial001.py, one test file for multiple variants. PR #1408 by @tiangolo.
• ✅ Simplify tests setup, one test file for multiple source variants. PR #1407 by @tiangolo.
• ✅ Refactor tests to use autouse clear_sqlmodel. PR #1406 by @tiangolo.
• ⬆ Bump mkdocs-material from 9.5.18 to 9.6.14. PR #1378 by @dependabot[bot].
• ⬆ Bump typer from 0.15.3 to 0.16.0. PR #1393 by @dependabot[bot].
• ⬆ Bump cairosvg from 2.7.1 to 2.8.2. PR #1383 by @dependabot[bot].
• ⬆ Bump ruff from 0.11.7 to 0.11.13. PR #1397 by @dependabot[bot].
• 🔧 Remove Google Analytics. PR #1386 by @tiangolo.
• ⬆ Bump mkdocs-macros-plugin from 1.0.5 to 1.3.7. PR #1354 by @dependabot[bot].
• ⬆ Bump griffe-typingdoc from 0.2.5 to 0.2.8. PR #1359 by @dependabot[bot].
• ⬆ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR #1360 by @dependabot[bot].
• ⬆ Bump pillow from 11.0.0 to 11.2.1. PR #1361 by @dependabot[bot].
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1367 by [@pre-commit-ci[bot]](h...

Upgrades

• ⬆️ Add support for Python 3.13. PR #1289 by @svlandeg.

Internal

• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1114 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.6.2 to 0.9.6. PR #1294 by @dependabot[bot].

Fixes

• 🐛 Fix type annotation in Field constructor. PR #1304 by @AlanBogarin.
• 🐛 Fix Pydantic version check for version 2.10.x onwards. PR #1255 by @asiunov.

Refactors

• 🚨 Fix types for new Pydantic. PR #1131 by @tiangolo.

Docs

• 🩺 Take the GH badge only from pushes to the main branch. PR #1291 by @svlandeg.
• 📝 Update documentation to refer to list instead of List. PR #1147 by @bubbletroubles.
• ✏️ Fix typo in databases.md. PR #1113 by @radi-dev.
• ✏️ Fix typo in docs/tutorial/create-db-and-table.md. PR #1252 by @ArianHamdi.
• ✏️ Fix typo in insert.md. PR #1256 by @Noushadaliam.
• 📝 Update markdown includes format. PR #1254 by @tiangolo.
• 📝 Update fenced code in Decimal docs for consistency. PR #1251 by @tiangolo.
• ✏️ Fix typo in the release notes of v0.0.22. PR #1195 by @PipeKnight.
• 📝 Update includes for docs/advanced/uuid.md. PR #1151 by @tiangolo.
• 📝 Update includes for docs/tutorial/create-db-and-table.md. PR #1149 by @tiangolo.
• 📝 Fix internal links in docs. PR #1148 by @tiangolo.
• ✏️ Fix typo in documentation. PR #1106 by @Solipsistmonkey.
• 📝 Remove highlights in indexes.md . PR #1100 by @alejsdev.

Internal

• ⬆ Bump pypa/gh-action-pypi-publish from 1.12.3 to 1.12.4. PR #1277 by @dependabot[bot].
• 💚 Fix CI test suite for Python 3.7. PR #1309 by @svlandeg.
• 👷 Revert "Add Codecov to CI, Smokeshow/Cloudflare has been flaky lately (#1303)". PR #1306 by @svlandeg.
• 👷 Add Codecov to CI, Smokeshow/Cloudflare has been flaky lately. PR #1303 by @tiangolo.
• 👷 Add retries to Smokeshow. PR #1302 by @svlandeg.
• ⬆ Bump astral-sh/setup-uv from 4 to 5. PR #1249 by @dependabot[bot].
• ⬆ Bump pillow from 10.3.0 to 11.0.0. PR #1139 by @dependabot[bot].
• ⬆ Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.12.3. PR #1240 by @dependabot[bot].
• ⬆ Bump astral-sh/setup-uv from 3 to 4. PR #1225 by @dependabot[bot].
• ⬆ Bump tiangolo/latest-changes from 0.3.1 to 0.3.2. PR #1207 by @dependabot[bot].
• 🔨 Update docs previews script. PR #1236 by @tiangolo.
• 🔧 Update build-docs filter paths. PR #1235 by @tiangolo.
• 🔧 Update team members. PR #1234 by @tiangolo.
• ⬆️ Upgrade markdown-include-variants to version 0.0.3. PR #1152 by @tiangolo.
• 👷 Update issue manager workflow. PR #1137 by @alejsdev.
• 👷 Fix smokeshow, checkout files on CI. PR #1136 by @tiangolo.
• 👷 Use uv in CI. PR #1135 by @tiangolo.
• ➕ Add docs dependency markdown-include-variants. PR #1129 by @tiangolo.
• 🔨 Update script to standardize format. PR #1130 by @tiangolo.
• 👷 Update labeler.yml. PR #1128 by @tiangolo.
• 👷 Update worfkow deploy-docs-notify URL. PR #1126 by @tiangolo.
• 👷 Upgrade Cloudflare GitHub Action. PR #1124 by @tiangolo.
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1097 by @pre-commit-ci[bot].
• ⬆ Bump tiangolo/issue-manager from 0.5.0 to 0.5.1. PR #1107 by @dependabot[bot].
• 👷 Update issue-manager.yml. PR #1103 by @tiangolo.
• 👷 Fix coverage processing in CI, one name per matrix run. PR #1104 by @tiangolo.
• 💚 Set include-hidden-files to True when using the upload-artifact GH action. PR #1098 by @svlandeg.
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1088 by @pre-commit-ci[bot].

Fixes

• 🐛 Fix support for types with Optional[Annoated[x, f()]], e.g. id: Optional[pydantic.UUID4]. PR #1093 by @tiangolo.

Docs

• ✏️ Fix a typo in docs/virtual-environments.md. PR #1085 by @tiangolo.
• 📝 Add docs for virtual environments and environment variables, update contributing. PR #1082 by @tiangolo.
• 📝 Add docs about repo management and team. PR #1059 by @tiangolo.
• ✏️ Fix typo in cascade_delete docs. PR #1030 by @tiangolo.

Internal

• ✅ Refactor test_enums to make them independent of previous imports. PR #1095 by @tiangolo.
• 👷 Update latest-changes GitHub Action. PR #1087 by @tiangolo.
• ⬆ [pre-commit.ci] pre-commit autoupdate. PR #1028 by @pre-commit-ci[bot].
• ⬆ Bump ruff from 0.4.7 to 0.6.2. PR #1081 by @dependabot[bot].
• 🔧 Update lint script. PR #1084 by @tiangolo.
• 👷 Update Python version for coverage. PR #1083 by @tiangolo.
• 🔧 Update coverage config files. PR #1077 by @tiangolo.
• 🔧 Add URLs to pyproject.toml, show up in PyPI. PR #1074 by @tiangolo.
• 👷 Do not sync labels as it overrides manually added labels. PR #1073 by @tiangolo.
• 👷 Update configs for GitHub Action labeler, to add only one label. PR #1072 by @tiangolo.
• 👷 Update labeler GitHub Actions permissions and dependencies. PR #1071 by @tiangolo.
• 👷 Add GitHub Action label-checker. PR #1069 by @tiangolo.
• 👷 Add GitHub Action labeler. PR #1068 by @tiangolo.
• 👷 Update GitHub Action add-to-project. PR #1067 by @tiangolo.
• 👷 Add GitHub Action add-to-project. PR #1066 by @tiangolo.
• 📝 Update admonitions in annotations. PR #1065 by @tiangolo.
• 📝 Update links from github.com/tiangolo/sqlmodel to github.com/fastapi/sqlmodel. PR #1064 by @tiangolo.
• 🔧 Update members. PR #1063 by @tiangolo.
• 💄 Add dark-mode logo. PR #1061 by @tiangolo.
• 🔨 Update docs.py script to enable dirty reload conditionally. PR #1060 by @tiangolo.
• 🔧 Update MkDocs previews. PR #1058 by @tiangolo.
• 💄 Update Termynal line-height. PR #1057 by @tiangolo.
• 👷 Upgrade build docs configs. PR #1047 by @tiangolo.
• 👷 Add alls-green for test-redistribute. PR #1055 by @tiangolo.
• 👷 Update docs-previews to handle no docs changes. PR #1056 by @tiangolo.
• 👷🏻 Show docs deployment status and preview URLs in comment. PR #1054 by @tiangolo.
• 🔧 Enable auto dark mode. PR #1046 by @tiangolo.
• 👷 Update issue-manager. PR #1045 by @tiangolo.
• 👷 Update issue-manager.yml GitHub Action permissions. PR #1040 by @tiangolo.
• ♻️ Refactor Deploy Docs GitHub Action to be a script and update token preparing for org. PR #1039 by @tiangolo.