Skip to content

runqy Documentation

Distributed Task Queue — Server-driven workers. Zero configuration. Deploy Python tasks at scale.

Get Started GitHub

What is runqy?

runqy is a task queue system where workers are stateless. They receive all configuration (Redis credentials, code deployment specs, task routing) from a central server at startup. This architecture enables:

  • Zero-configuration workers: Workers only need to know the server URL
  • Centralized control: All queue and deployment configuration lives on the server
  • Dynamic code deployment: Workers automatically pull and run your task code
  • Powerful CLI: Manage queues, tasks, and workers locally or remotely

Components

  • runqy Server — Go HTTP server for worker registration, queue management, and REST API
  • runqy Worker — Go binary that processes tasks from Redis and supervises Python processes
  • runqy-python — Python SDK with @task and @load decorators for building task handlers (also includes a client for enqueuing)

Source Code