---
id: faktory
version: "1.0.0"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# faktory — Python worker for the Faktory project

License: permissive · Maintenance: dormant · Downloads: 405.5K/mo

## 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 above — 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

pip install faktory
uv add faktory
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_current
- Install friction: low
- Maintenance: dormant
- Downloads: 405.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

faktory job worker, job queue processing, distributed task queue, faktory python client, background job worker, job server integration, concurrent job processing, job-queue, background-tasks, multiprocessing

[View on SkillFed](https://skillfed.io/packages/faktory) · [View on PyPI](https://pypi.org/project/faktory/)