coleifer

huey: Run Background Tasks in Python

Huey is a lightweight Python task queue for moving work out of request-handling code and running it in the background. It supports several storage backends, scheduled and recurring tasks, retries, and Django integration.

View on GitHub Compare
Stars
6k
Forks
404
Stars, last 30 days
+7
Last commit
today
Contributors
54

Our take

Activeregular commits and releases

Health score

59/100

How it is scored
Activity
67
Community
46
Issues
79
Pull requests
43

+7 stars in the last 30 days

  • Closes issues faster than 81% of the projects we track

Huey is a mature, actively maintained Python task queue with frequent releases, but its measured contribution share is concentrated in one person despite a broader contributor history.

Good fit if

  • You need Python background jobs, delayed or recurring execution, and task results in one library.
  • You want a choice of storage backends and worker models, including Django integration.
  • You are comfortable adopting an MIT-licensed project whose recent activity is strong but whose contributions are concentrated.

Look elsewhere if

  • You need a queue outside the Python ecosystem or a project with less dependence on one contributor.
  • Your architecture requires a broker or execution model not listed among Huey's supported options.
  • You need evidence of an included test suite from the available project facts, which do not indicate one.
All health signals
Last commit2026-10-13 (today)
Commits, last 90 days63
Releases, last 12 months17 (latest 3.4.0, 2026-09-04)
Contributors54 (top contributor: 92% of commits)
Issues closed, last 90 days7 (typically closed in 0 days)
Pull requests merged, last 90 days1
Project age14 years

Checked on 2026-10-14 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

6,062

Forks

407

Change since Nov 17, 2026: +1 stars·0 forks

Overview

Huey is a Python task queue for applications that need to run work outside the main request or process flow. It lets an application enqueue function calls and have a separate consumer execute them, with optional result retrieval and scheduling.

It fits teams that want a compact queue with built-in storage choices rather than a service tied to Redis alone. The project is active, with regular commits and releases, though its measured contribution history is highly concentrated in one person.

Key Features

  • Run queued tasks using Redis-compatible, PostgreSQL, SQLite, file-system, or in-memory storage.
  • Execute work with process, thread, or greenlet workers.
  • Schedule one-off delayed tasks and recurring tasks.
  • Retry failed tasks, with configurable retry counts and delays.
  • Store task results and configure task expiration.
  • Control execution with task priorities, locks, rate limits, and timeouts.
  • Compose work into pipelines, chains, groups, and chords.
  • Integrate with Django, including optional admin visibility and management.

Use Cases

  • A Python web application can enqueue email delivery, report generation, or other slow work so request handlers do not have to perform it inline.
  • A Django team can use Huey for background jobs and inspect or manage them through the provided admin integration.
  • An application can schedule recurring maintenance or backups without building a separate scheduling layer.
  • A service can use retries and rate limits when its background tasks call unreliable or constrained external services.
  • A team that does not want to operate Redis can use Huey's PostgreSQL, SQLite, file-system, or in-memory storage options, subject to each backend's suitability for its deployment.

What you need

Detected in the repository

  • Python (from pyproject.toml)
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Run the consumer against your application's Huey instance:

huey_consumer my_app.huey

See the README and documentation for installation, configuration, and task examples.

Alternatives

  • dramatiq: Dramatiq is a Python background-job queue using RabbitMQ or Redis, while Huey offers additional storage backends, scheduling, retries, and Django integration.
ProjectLanguageLicenseStarsStatus
hueyPythonMIT6kActive
dramatiqPythonLGPL-3.05.3kActive

Considerations

Huey is not archived and has recent commits and releases, but contributor activity is highly concentrated in one person. Teams should account for that concentration when assessing long-term maintenance risk. Redis-compatible storage requires redis-py, and PostgreSQL storage requires psycopg; the README describes the library as otherwise having zero dependencies. The available project facts identify Python as the runtime and CI as present, but do not indicate a test suite. The MIT license permits broad use, subject to retaining the license and copyright notice when distributing copies.

Found this useful?

Share it with someone who would like huey.

Comparisons