faktory

Python worker for the Faktory project

faktory v1.0.0 405.5K downloads/30d#6,904 on PyPI★ 71

Permissive license BSD DORMANT released 2022-04-30

What it is and what it does

Faktory is a Python client and worker library for the Faktory job server, a language-agnostic background job processor. It lets you push jobs from Python code to a Faktory server for processing, or run a Python worker that consumes and executes those jobs. The worker supports concurrency via multiple processes (default) or threads, graceful shutdown, TLS encryption, password authentication, and can report worker status and errors back to the server.

The package has no external runtime dependencies and installs with low friction. However, it requires a separate Faktory server to be running and accessible over the network. The library is in Alpha status and maintenance is dormant—the last release was in April 2022 and the repository has not been updated since September 2023, meaning you should expect no active support for new Faktory versions or bug fixes.

Use it for:

Run a Python worker that pulls jobs from a Faktory queue and executes them with configurable concurrency.
Push background tasks to Faktory from a Python application for processing by any Faktory-compatible worker.
Build a multi-language job processing pipeline where Python workers coexist with workers in other languages.
Schedule delayed or retried jobs through Faktory with custom metadata from Python code.
Monitor and control workers via Faktory's web UI while running Python job handlers.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python worker and client library for Faktory, a language-agnostic job server; lets you consume jobs from Faktory or push jobs to it for processing.

Yes, if you are already committed to running Faktory and need a Python worker or client. The package is simple, dependency-free, and works with current Python versions. However, do not adopt it for new projects expecting active maintenance—the dormant status and lack of updates since 2023 mean you will be on your own for compatibility issues with future Faktory releases or Python versions.

Install

faktory on PyPI

pip

pip install faktory

uv

uv add faktory

poetry

poetry add faktory

Installing faktory

Before you install

Low install friction with no runtime dependencies. Maintenance is dormant—last release was 2022-04-30 and the repository has not been updated since 2023-09-11, so expect no active bug fixes or feature development.

License in practice

BSD license is permissive, allowing commercial and private use with minimal restrictions; you may use and modify this package freely provided you include the license notice.

Quickstart

pip install faktory

from faktory import Worker

def your_function(x, y):
    return x + y

w = Worker(queues=['default'], concurrency=1)
w.register('test', your_function)
w.run()

Requires Python 3.7 or later; requires a running Faktory server accessible via TCP (default localhost:7419).

Verify before relying

Whether the package works reliably with Faktory versions beyond 1.0 given the dormant maintenance status.
Current state of the Django integration mentioned as 'in progress' in the description.
Whether pickling issues with decorated functions in multiprocessing mode are documented or resolved.

Package facts

License	BSD (permissive)
Python support	supports the current Python release (>=3.7.0)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	dormant — 1,567 days since the last release
Last repo commit	2023-09-11
First released	2017-11-12
Downloads	405,536/month — #6,904 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-14)