Features

• ✨ Add support for SQLAlchemy 2.1. PR #2112 by @tiangolo.

Internal

• ⬆ Bump the python-packages group across 1 directory with 8 updates. PR #2110 by @dependabot[bot].
• ⬆ Bump the github-actions group with 3 updates. PR #2109 by @dependabot[bot].
• ⬆ Bump pre-commit hooks. PR #2108 by @pr-submit[bot].

Features

• ✨ Add direct support for PostgreSQL, MySQL, and MariaDB, include in CI tests. PR #2103 by @tiangolo.

Fixes

• 🐛 Fix timedelta arithmetic with UTC datetime fields. PR #2101 by @tiangolo.

Breaking Changes

• ✨ Use UTC datetimes by default. PR #2099 by @tiangolo.

datetime fields now use UTCDateTime, a custom type based on DateTime(timezone=True). It requires aware datetime parameters, normalizes them to UTC, and returns aware UTC values from database reads, including on SQLite and MySQL/MariaDB. Pydantic's AwareDatetime uses the same type, while NaiveDatetime explicitly selects DateTime(timezone=False). Plain datetime validation still accepts both aware and naive values, but naive database parameters now raise an error.

Existing databases are not changed automatically. To retain naive storage, use NaiveDatetime or an explicit Field(sa_type=DateTime(timezone=False)). Explicit SQLAlchemy types retain their existing behavior. PostgreSQL needs a column migration that explicitly specifies the timezone of existing values. SQLite and MySQL/MariaDB keep their column definitions, but existing non-UTC values need a data migration before adopting the new type. Update datetime producers, query parameters, comparisons, and any database defaults to follow the new UTC convention.

Read Datetimes and Timezones: Upgrade Existing Applications before upgrading.

Refactors

• ♻️ Replace the dataclass_transform shim with typing_extensions. PR #2097 by @tiangolo.

Fixes

• 🐛 Fix SQLAlchemy type handling in Field. PR #2095 by @tiangolo.

Internal

• ⬆ Bump sqlalchemy from 2.0.51 to 2.0.52. PR #2086 by @dependabot[bot].
• ⬆ Bump the python-packages group with 9 updates. PR #2085 by @dependabot[bot].
• ⬆ Bump the github-actions group with 4 updates. PR #2084 by @dependabot[bot].
• ⬆ Bump pre-commit hooks. PR #2083 by @pr-submit[bot].

Features

• 🏷️ Allow Discriminator type for discriminator parameter in Field. PR #1729 by @YuriiMotov.

Refactors

• 🗑️ Deprecate min_items and max_items parameters of Field. PR #1731 by @YuriiMotov.

Docs

• ✏️ Fix grammar and typos in docs. PR #2058 by @YuriiMotov.
• 📝 Fix "Decimals in SQLModel" to reference Field() instead of condecimal(). PR #2035 by @anxkhn.
• 🐛 Use buttons for Termynal controls. PR #2063 by @tiangolo.
• 📝 Add Library Skills documentation. PR #2052 by @tiangolo.
• 📝 Recommend uv projects by default in docs. PR #2050 by @tiangolo.
• 🐛 Prevent Termynal controls from scrolling. PR #2051 by @tiangolo.
• 📝 Update help docs. PR #2049 by @tiangolo.

Internal

• ⬆️ Bump Typer min version to 0.26.1. PR #2078 by @YuriiMotov.
• ⬆️ Bump setup-uv action to 10.0.1. PR #2077 by @YuriiMotov.
• 👷 Migrate automatic labels to Latest Changes. PR #2074 by @tiangolo.
• 👷 Remove legacy label check. PR #2072 by @tiangolo.
• 🔐 Use PR Submit for pull requests. PR #2071 by @tiangolo.
• 👷 Use GitHub CLI for Git authentication. PR #2070 by @tiangolo.
• 👷 Use PR Push commit identity. PR #2069 by @tiangolo.
• 🔒 Replace pre-commit PAT with PR Push. PR #2067 by @tiangolo.
• 👷 Remove Zensical docs cache. PR #2065 by @tiangolo.
• 🔥 Remove the old Latest Changes workflow. PR #2064 by @tiangolo.
• ⬆ Bump the python-packages group with 7 updates. PR #2060 by @dependabot[bot].
• ⬆ Bump the github-actions group with 5 updates. PR #2059 by @dependabot[bot].
• ⬆️ Upgrade latest-changes to 0.7.1. PR #2054 by @tiangolo.
• ⬆ Bump the python-packages group across 1 directory with 6 updates. PR #2042 by @dependabot[bot].
• ⬆ Bump the github-actions group across 1 directory with 4 updates. PR #2045 by @dependabot[bot].
• 👷 Add GH workflow to bump pre-commit hook versions. PR #2026 by @YuriiMotov.
• 🔧 Set Dependabot schedule interval to "monthly". PR #2025 by @YuriiMotov.
• ⬆ Bump the python-packages group with 4 updates. PR #2039 by @dependabot[bot].
• ⬆ Bump https://github.com/crate-ci/typos from v1.47.2 to 1.48.0 in the pre-commit group. PR #2038 by @dependabot[bot].
• 👷 Fix latest-changes checkout target. PR #2031 by @tiangolo.
• ⬆️ Update issue-manager to 0.8.1. PR #2030 by @tiangolo.
• ⬆️ Update latest-changes to 0.6.1. PR #2029 by @tiangolo.
• ⬆ Bump the python-packages group across 1 directory with 8 updates. PR #2028 by @dependabot[bot].
• ⬆ Bump the github-actions group with 4 updates. PR #2027 by @dependabot[bot].
• ⬆ Bump sqlalchemy from 2.0.50 to 2.0.51. PR #2013 by @dependabot[bot].
• 👷 Update release workflows, fix gitmoji emoji used. PR #2019 by @tiangolo.

Features

• ✨ Add SQLModel Agent Library Skill, install with uvx library-skills. PR #2017 by @tiangolo.

Fixes

• 🐛 Fix type of __sqlmodel_relationships__. PR #1996 by @svlandeg.

Docs

• 📝 Update docs badges: remove Publish badge, it doesn't give extra information. PR #2009 by @tiangolo.
• 📝 Update and simplify docs about help and management. PR #1978 by @tiangolo.
• 📝 Update docs about contributing, reference central docs. PR #1975 by @tiangolo.
• 📝 Update security policy. PR #1973 by @tiangolo.
• 📝 Update link syntax to minimal Markdown. PR #1800 by @tiangolo.
• 📝 Update admonitions, simplify and use defaults. PR #1915 by @tiangolo.
• 🔒️ Only allow team members to modify dependencies. PR #1914 by @svlandeg.

Internal

• 👷 Simplify pull request workflow triggers. PR #2016 by @tiangolo.
• 👷 Update issue-manager to 0.7.1. PR #2015 by @tiangolo.
• ⬆️ Update issue-manager to 0.7.0. PR #2014 by @tiangolo.
• 🔒️ Update zizmor workflow security checks. PR #2010 by @tiangolo.
• 👷 Fix alls-green test dependency. PR #2008 by @tiangolo.
• ⬆ Bump the python-packages group with 5 updates. PR #2006 by @dependabot[bot].
• ⬆ Bump https://github.com/crate-ci/typos from v1.47.1 to v1.47.2 in the pre-commit group. PR #2005 by @dependabot[bot].
• ⬆ Bump astral-sh/setup-uv from 8.1.0 to 8.2.0 in the github-actions group. PR #2004 by @dependabot[bot].
• ⬆ Bump the python-packages group with 3 updates. PR #2000 by @dependabot[bot].
• ⬆ Bump https://github.com/crate-ci/typos from v1.46.0 to v1.47.1 in the pre-commit group. PR #1999 by @dependabot[bot].
• ⬆ Bump the github-actions group with 2 updates. PR #1998 by @dependabot[bot].
• ⬆ Bump sqlalchemy from 2.0.49 to 2.0.50. PR #1992 by @dependabot[bot].
• ⬆ Bump the python-packages group across 1 directory with 9 updates. PR #1995 by @dependabot[bot].
• ⬆ Bump eps1lon/actions-label-merge-conflict from 3.0.3 to 3.1.0 in the github-actions group. PR #1993 by @dependabot[bot].
• ⬆️ Bump Pydantic to 2.13.4. PR #1985 by @YuriiMotov.
• 👷 Automate release preparation. PR #1988 by @tiangolo.
• 🔥 Remove old package stub slim, not used nor needed. PR #1987 by @tiangolo.
• ⬆ Bump the github-actions group with 2 updates. PR #1983 by @dependabot[bot].
• 👷 Configure Dependabot to group updates and update weekly. PR #1972 by @YuriiMotov.
• 🔥 Remove config files now in central GitHub repo. PR #1979 by @tiangolo.
• ⬆ Bump zizmorcore/zizmor-action from 0.5.3 to 0.5.5. PR #1974 by @dependabot[bot].
• 👷 Fix branch name in guard-dependencies.yml. PR #1916 by @svlandeg.
• ♻️ Migrate docs to Zensical. PR #1913 by @tiangolo.
• ⬆ Bump ruff from 0.15.12 to 0.15.13. PR #1910 by @dependabot[bot].
• 🔒️ Add zizmor and fix audit findings. PR #1871 by @YuriiMotov.
• ⬆ Bump ty from 0.0.34 to 0.0.35. PR #1904 by @dependabot[bot].
• ⬆ Bump actions/add-to-project from 1.0.2 to 2.0.0. PR #1900 by @dependabot[bot].
• ⬆ Bump actions/labeler from 6.0.1 to 6.1.0. PR #1902 by @dependabot[bot].
• ⬆ Bump pydantic-settings from 2.14.0 to 2.14.1. PR #1903 by @dependabot[bot].
• ⬆ Bump prek from 0.3.11 to 0.3.13. PR #1901 by @dependabot[bot].
• 👷 Add pre-commit for typos. PR #1899 by @tiangolo.
• ⬆ Bump ty from 0.0.32 to 0.0.34. PR #1898 by @dependabot[bot].
• ⬆ Bump typer from 0.25.0 to 0.25.1. PR #1896 by @dependabot[bot].
• ⬆ Bump prek from 0.3.10 to 0.3.11. PR #1892 by @dependabot[bot].
• ⬆ Bump typer from 0.24.2 to 0.25.0. PR #1893 by @dependabot[bot].
• ⬆ Bump ruff from 0.15.11 to 0.15.12. PR #1888 by @dependabot[bot].
• ⬆ Bump fastapi from 0.136.0 to 0.136.1. PR #1887 by @dependabot[bot].
• ⬆ Bump typer from 0.24.1 to 0.24.2. PR #1883 by @dependabot[bot].
• ⬆ Bump prek from 0.3.9 to 0.3.10. PR #1881 by @dependabot[bot].
• ⬆ Bump ty from 0.0.31 to 0.0.32. PR #1876 by @dependabot[bot].
• ⬆ Bump pydantic-settings from 2.13.1 to 2.14.0. PR #1878 by @dependabot[bot].
• ⬆ Bump cloudflare/wrangler-action from 3.14.1 to 3.15.0. PR #1868 by @dependabot[bot].
• ⬆ Bump ty from 0.0.30 to 0.0.31. PR #1862 by @dependabot[bot].
• ⬆ Bump actions/cache from 5.0.4 to 5.0.5. PR #1865 by @dependabot[bot].
• ⬆ Bump actions/upload-artifact from 7.0.0 to 7.0.1. PR #1867 by @dependabot[bot].
• ⬆ Bump astral-sh/setup-uv from 7.6.0 to 8.1.0. PR #1866 by @dependabot[bot].
• ⬆ Bump fastapi from 0.135.3 to 0.136.0. PR #1869 by @dependabot[bot].
• ⬆ Bump ruff from 0.15.10 to 0.15.11. PR #1870 by @dependabot[bot].
• 🔒 Pin GitHub actions by commit SHA. PR #1840 by @YuriiMotov.
• ⬆ Bump ty from 0.0.29 to 0.0.30. PR #1861 by @dependabot[bot].
• ⬆ Bump prek from 0.3.8 to 0.3.9. PR #1859 by @dependabot[bot].
• ⬆ Bump ruff from 0.15.9 to 0.15.10. PR #1856 by @dependabot[bot].
• ⬆ Bump pytest from 9.0.2 to 9.0.3. PR #1855 by [@dependabot[bot]](https://github.com/apps/de...