Разница между .py и .pyi файлами заключается в их назначении и содержании.

.py — стандартное расширение для файлов скриптов на языке Python. 1 Такие файлы представляют собой текстовые файлы, которые содержат код Python и могут быть выполнены интерпретатором. 1

.pyi — расширение для файлов интерфейса Python, или заглушек. 13 Такие файлы содержат информацию о типах, которая не может быть выражена напрямую в коде Python. 1 Они не предназначены для выполнения, а используются инструментами проверки типов, такими как Mypy, PyCharm или Pyright, для улучшения качества кода и обнаружения потенциальных ошибок на ранних этапах разработки. 1

Таким образом, разница заключается в том, что .py-файлы содержат полный код программы, а .pyi-файлы — только информацию о типах элементов соответствующего .py-файла. 13