Skip to content

CLI crashes on Python 3.14: Typer 0.12.5 incompatible with PEP 649 annotation evaluation #208

@jeff-schnitter

Description

@jeff-schnitter

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions