Missing py.typed marker — mypy reports import-untyped

[notdodo]

Problem

mypy reports import-untyped when importing tavily:

Skipping analyzing "tavily": module is installed, but missing library stubs or py.typed marker [import-untyped]

Root Cause

The tavily package uses inline type annotations (e.g. in async_tavily.py, utils.py, config.py, errors.py) but does not include a py.typed marker file. Without this file, mypy does not recognize the package as typed and falls back to import-untyped.

Reproduction

pip install tavily-python
python -c "import tavily"
mypy --strict -c "import tavily"
# Error: Skipping analyzing "tavily": module is installed, but missing library stubs or py.typed marker

Fix

Add a py.typed file to the package root (empty file, just the marker):

tavily/py.typed

And ensure it is included in the package data in pyproject.toml or setup.py.

References

• PEP 561: https://peps.python.org/pep-0561/#package-types-information
• mypy docs: https://mypy.readthedocs.io/en/stable/#running-mypy-on-third-party-code