Problem
Running cortex --help on Python 3.14 crashes immediately with a traceback in inspect.get_annotations(). Python 3.14 introduced PEP 649 (deferred evaluation of annotations) which changes how inspect.signature() works internally. Typer 0.12.5 is not compatible with this change.
The crash occurs in custom_events.py:update_by_uuid during Typer's command registration, but the root cause is the Typer version.
Reported by
Vassilis Benopoulos (Blackstone) — unable to install and use the CLI on Python 3.14.
Fix
- Update
typer from ^0.12.5 to >=0.15,<1.0 (0.26.5 resolved)
- Remove the
click<8.2 pin (newer Typer manages its own click dependency)
- Update CI to test on Python 3.14 by default
Branch: fix-python-314-typer-upgrade
Problem
Running
cortex --helpon Python 3.14 crashes immediately with a traceback ininspect.get_annotations(). Python 3.14 introduced PEP 649 (deferred evaluation of annotations) which changes howinspect.signature()works internally. Typer 0.12.5 is not compatible with this change.The crash occurs in
custom_events.py:update_by_uuidduring Typer's command registration, but the root cause is the Typer version.Reported by
Vassilis Benopoulos (Blackstone) — unable to install and use the CLI on Python 3.14.
Fix
typerfrom^0.12.5to>=0.15,<1.0(0.26.5 resolved)click<8.2pin (newer Typer manages its own click dependency)Branch:
fix-python-314-typer-upgrade