Troubleshooting#

Common Issues#

"uv: command not found"#

Solution: Install uv using the installation script or pip:

curl -LsSf https://astral.sh/uv/install.sh | sh
# Then restart your terminal

Pre-commit hooks failing#

Solution: Run hooks manually to see detailed errors:

uv run pre-commit run --all-files

MyPy errors on protobuf files#

Solution: Protobuf generated files are excluded in configuration. If you see errors, check that files match the exclusion patterns in pyproject.toml.

Import errors during type checking#

Solution: Ensure all dependencies are installed:

uv sync