Skip to main content
Set up the python development environment using uv:
git clone https://github.com/ArchiveBox/abxbus && cd abxbus

# Create virtual environment with Python 3.12
uv venv --python 3.12

# Activate virtual environment (varies by OS)
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

# Install dependencies
uv sync --dev --all-extras
Recommended once per clone:
prek install           # install pre-commit hooks
prek run --all-files   # run pre-commit hooks on all files manually

# Run linter & type checker
uv run ruff check --fix
uv run ruff format
uv run pyright

# Run all tests
uv run pytest -vxs --full-trace tests/

# Run specific test file
uv run pytest tests/test_eventbus.py

# Run Python perf test suite
uv run pytest tests/test_eventbus_performance.py -vxs

# Run the entire lint+test+examples+perf suite for both python and ts
./test.sh
For AbxBus-TS development see the abxbus-ts/README.md # Development section.