Minimum Viable Architecture

Just Postgres + your app + stateless workers. That’s it.

Pieces

  1. Postgres — durable storage for tasks, schedules, retries.
  2. Producer — your API/UI enqueues tasks via the SDK.
  3. Worker — stateless, horizontally scalable containers.

No Redis, no brokers, no vendor lock‑in.

1. Postgres

Source of truth for queues, schedules, retries, and task state using transactional writes and lightweight leases.

2. Producer

Your API/UI or backend services enqueue tasks via the Hyrex SDK with optional idempotency keys and schedule/cron metadata.

3. Worker

Stateless executors that pull, lease, and execute tasks; they scale horizontally and safely fail over during deploys or crashes.

Logs

Optionally ship structured execution logs to S3 for durable storage, long-term retention, or external analytics.

Just Configure with Env Vars

Configure your setup just by adding these secrets to your .env.

# Postgres connection for Hyrex (not needed for Hyrex Cloud)
HYREX_DATABASE_URL="postgres://USER:PASSWORD@HOST:5432/DBNAME"

# Optional: S3 bucket for logs (not needed for Hyrex Cloud)
HYREX_S3_LOG_BUCKET="s3://my-hyrex-logs"

# Managed Hyrex API key (not needed for open-source)
HYREX_API_KEY="your-managed-hyrex-api-key"