Nex Arq Worker Pattern

Production-ready ARQ background workers for FastAPI with Redis heartbeats, cron jobs, and hardened systemd units.

Install
cmdop skills install agensi-nex-arq-worker-pattern

Robust Background Processing for FastAPI

The Nex ARQ Worker Pattern provides a production-grade, asynchronous background job system designed specifically for FastAPI applications running on resource-constrained environments like Raspberry Pi or dedicated Linux VPS instances. It eliminates the complexity of Celery while providing more reliability than standard FastAPI BackgroundTasks by using a Redis-backed queue that survives application restarts.

What it does

  • Generates a complete ARQ worker configuration with heartbeats and health monitoring.
  • Provides a thread-safe, cached Redis pool for non-blocking job enqueuing from your API.
  • Implements a persistent heartbeat system that allows your API to report worker health status.
  • Configures hardened systemd service units for non-root execution and process reliability.
  • Includes boilerplate for scheduled cron-style tasks (e.g., daily cleanups or data syncs).

Why use this skill

Standard Python job runners are often either too heavy (Celery) or too volatile (in-memory queues). This skill implements the "Nex Pattern": a battle-tested approach for multi-tenant SaaS apps that requires minimal memory, provides high visibility into worker health, and secures the process using Linux system hardening best practices. It ensures your background jobs are observable, restartable, and secure by default.

Built by Nex AI. More skills and info at nex-ai.be and slopsome.com.