Mirror of https://github.com/roostorg/osprey
github.com/roostorg/osprey
1# Troubleshooting
2
3## Common Issues
4
5### "uv: command not found"
6
7**Solution**: Install uv using the installation script or pip:
8
9```bash
10curl -LsSf https://astral.sh/uv/install.sh | sh
11# Then restart your terminal
12```
13
14### Pre-commit hooks failing
15
16**Solution**: Run hooks manually to see detailed errors:
17
18```bash
19uv run pre-commit run --all-files
20```
21
22### MyPy errors on protobuf files
23
24**Solution**: Protobuf generated files are excluded in configuration. If you see errors, check that files match the exclusion patterns in `pyproject.toml`.
25
26### Import errors during type checking
27
28**Solution**: Ensure all dependencies are installed:
29
30```bash
31uv sync
32```