https://github.com/brunoportis/localqueue

Durable local queues for Python workers, scripts, and CLI tools.
https://github.com/brunoportis/localqueue

cli python queue retry sqlite workers

Last synced: 2 months ago
JSON representation

Durable local queues for Python workers, scripts, and CLI tools.

• Host: GitHub
• URL: https://github.com/brunoportis/localqueue
• Owner: brunoportis
• License: mit
• Created: 2026-04-18T17:58:28.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2026-04-22T13:05:21.000Z (2 months ago)
• Last Synced: 2026-04-22T14:13:26.962Z (2 months ago)
• Topics: cli, python, queue, retry, sqlite, workers
• Language: Python
• Homepage: https://brunoportis.github.io/localqueue/
• Size: 148 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# `localqueue`

[![Tests](https://github.com/brunoportis/localqueue/actions/workflows/tests.yml/badge.svg)](https://github.com/brunoportis/localqueue/actions/workflows/tests.yml)

[![CodeQL](https://github.com/brunoportis/localqueue/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/brunoportis/localqueue/actions/workflows/github-code-scanning/codeql)

![Coverage](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen)

`localqueue` is a small durable queue for one machine. It stores work on the local filesystem by default and keeps retry state with Tenacity.

Use it for scripts, CLI tools, cron jobs, and small Python workers that share one local store. Use `localqueue.retry` when another system already delivers work and you only need retry state that survives restarts.

```bash

localqueue queue exec emails -- python scripts/send_email.py

```

```python

from localqueue import PersistentQueue, persistent_worker

queue = PersistentQueue("emails")

queue.put({"to": "user@example.com"})

@persistent_worker(queue)

def send_email(job: dict[str, str]) -> None:

    deliver(job["to"])

```

Full docs live at [brunoportis.github.io/localqueue](https://brunoportis.github.io/localqueue/). The source docs are in [`docs/`](docs/).

## Install

```bash

pip install localqueue

```

For the CLI:

```bash

pip install "localqueue[cli]"

```

For the optional LMDB backend:

```bash

pip install "localqueue[lmdb]"

```

## When not to use

`localqueue` is not a distributed broker. If you need multi-host coordination, high write concurrency, managed retention, or strict cross-service ordering, use a system designed for that operating model.