Horsies
PostgreSQL-backed background task queue and workflow engine for Python.
Full Documentation | PyPI | GitHub
Why Postgres
Every guarantee horsies makes is a Postgres primitive, not a client-side convention:
- Claiming: one server-side function under
FOR UPDATE SKIP LOCKED; a claim-generation fence rejects stale attempts, including a worker re-claiming its own requeued task. - Finalization: row lock → immutable attempt-history append → state transition, one transaction.
- Recovery: all state is rows and timestamps; the reaper reconstructs and repairs after a worker dies mid-flight — nothing in-flight exists only in a broker's memory.
- Workflows: fan-in, completion, and subworkflow cascades are multi-row transitions under a documented lock order.
- Dispatch: LISTEN/NOTIFY push — no polling.
- Inspection: history is plain tables — SQL,
EXPLAIN, your existing backups; Syce reads the same rows.
Measured hot-path latencies: performance.
Monitoring
Horsies includes Syce, a terminal-based UI for monitoring your cluster in real-time.
Testing & Correctness
3,200+ test functions across unit, real-Postgres integration, e2e
worker-process, and PgBouncer contract suites — a 2.2:1 test-to-source line
ratio, weighted toward failure paths: crash recovery, claim fencing,
cancel/completion races, rolling upgrades, and EXPLAIN ANALYZE plan
assertions pinning the hot-path statements to their indexes. The
claim/finalize semantics are additionally cross-validated against an
independent Rust reimplementation of the engine.
Pre-1.0 is an API-contract statement, not an engine-maturity statement: breaking API changes may still land in minor releases and are documented in the changelog.
1 maintainer
Metadata
1 maintainer
Release files for horsies 0.5.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| horsies-0.5.4.tar.gz | 1.1 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| horsies-0.5.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.4 MB
Release files / horsies-0.5.4.tar.gz
| Download URL | horsies-0.5.4.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c53c7037ab2b25d32c95794792460a9a3664762bea4e839dec596ac2cbc95474
|
|
BLAKE2b-256 checksum How to use checksums |
b2a3800cf9704b80949cc87de97fd69b34a9aed1f159c46cda1c292a1c9d58c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logRelease files / horsies-0.5.4-py3-none-any.whl
| Download URL | horsies-0.5.4-py3-none-any.whl |
|---|---|
| Size | 1.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3288be32a65f19ef6ab08607ea47cb6dfa1eea392941aad033a255151e3b6d70
|
|
BLAKE2b-256 checksum How to use checksums |
cef8936a4950ea2f50bb902fd9aadab06b3338769b3d0ff290bac030207e56c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logSecurity for horsies 0.5.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for horsies-0.5.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
