Skip to main content

Installation

PyPI Install​

pip install batho          # pip
uv pip install batho       # uv
pip install -e .           # development (editable)

PyPI: https://pypi.org/project/batho/

Developer Setup (uv)​

Use this section when you want to contribute to Batho locally, run tests, and verify the CLI from source.

1. Clone the repository​

git clone https://github.com/sageoz/batho.git
cd batho

2. Install project dependencies​

uv sync --all-groups --all-extras

This creates and syncs the project environment with runtime, test, and dev dependencies.

3. Run tests​

# Full suite
uv run pytest

# Optional: focused checks while iterating
uv run pytest tests/core/test_config.py -q
uv run pytest tests/utils/test_logging.py -q

4. Run the CLI directly from local source​

uv run python -m batho_cli --help
uv run python -m batho_cli index --root .

5. Reinstall the global batho command​

uv tool install --reinstall .
hash -r
batho index --root .

6. Quick troubleshooting​

If behavior differs between local and global runs, compare both paths:

uv run python -m batho_cli index --root .
batho index --root .

If they differ, reinstall the tool again:

uv tool install --reinstall .
hash -r