Skip to content

Installation

Requirements

  • Python >= 3.13
  • Celery >= 5.5.0
  • Redis >= 7.0 (for BZMPOP) or Valkey (any version)

Install

uv add celery-redis-plus

You'll also need a client library. Choose one:

# For Valkey (recommended)
uv add celery-redis-plus[valkey]

# For Valkey with libvalkey C extension (faster)
uv add celery-redis-plus[libvalkey]

# For Redis
uv add celery-redis-plus[redis]

# For Redis with hiredis C extension (faster)
uv add celery-redis-plus[hiredis]

Development Installation

# Clone the repository
git clone https://github.com/oliverhaas/celery-redis-plus.git
cd celery-redis-plus

# Create virtual environment and install with development dependencies
uv venv
uv sync --group dev

# Run tests (requires Docker for integration tests)
uv run pytest

# Run linter
uv run ruff check

# Run type checker
uv run ty check