Dependencies

Core Dependencies

• Python >= 3.10

• Poetry >= 2.3.0 - poetry export

Supported Poetry Versions by PTB

PTB Poetry Version Compatibility

PTB Version	Default in PTB	Range Allowed	Migration Information
>=1.0.0, <5.0.0	2.1.2	>=2.1.0,<3.0	None
>=5.0.0	2.3.0	>=2.3.0,<3.0	From Poetry 2.1.x to 2.3.0

Migration Information

From Poetry 2.1.x to 2.3.0

It is highly encouraged that a developer update their pyproject.toml and system-wide Poetry installation to most effectively use Poetry 2.3.0:

1. In your terminal, update your system-wide Poetry version:

   poetry self update 2.3.0
   

2. In your project’s pyproject.toml, update the requires-poetry value:

   requires-poetry = ">=2.3.0"
   

3. In your terminal, execute poetry check and resolve any listed issues

4. In your terminal, run poetry lock to update the lock

5. (optional but recommended) In your project’s pyproject.toml, update it to fit:

   • PEP-621

   • PEP-735

   Note

   Note that uvx migrate-to-uv seems to do a good job with automating many of the PEP-related changes. Though, a developer should take care to verify the changes, as some are unneeded as it completes the migration to uv which the PTB does NOT yet support.