Welcome to UpNext

Two ways to run
Get started
Learn more

UpNext is a framework for running background workers, APIs, cron jobs, and event-driven tasks with a shared Redis-backed runtime. Define your work with simple decorators, monitor everything from a real-time dashboard.

Two ways to run

UpNext works in two modes. Start with SDK + Redis to get the core runtime, then add the server when you want monitoring, persistent history, and management tools.

SDK + Redis
SDK + Redis + Server

Everything you need to run workers and APIs. Just install the package and point at Redis.

Feature
Background tasks	Retries, timeouts, progress tracking
Workflows	Nested tasks with parent-child lineage and failure propagation
Cron jobs	Recurring schedules with standard cron syntax
Events	Pub/sub handlers with typed payloads
HTTP APIs	Endpoints powered by FastAPI
Parallel execution	`gather`, `map_tasks`, `first_completed`
Error handling	Automatic retries, backoff, and durable failure history

pip install upnext
UPNEXT_REDIS_URL=redis://localhost:6379 upnext run service.py

Everything above, plus a dashboard and management layer. The server adds features that require persistent storage.

Feature
Dashboard	Real-time web UI for jobs, workers, APIs, and metrics
Job history	Persistent, queryable history of all executions
Artifacts	Attach outputs (JSON, images, PDFs) to jobs and browse them
Authentication	Optional single-token gate for the dashboard and API
Workspaces	Workspace-scoped runtime state

Backend-first: set UPNEXT_BACKEND explicitly. The example below uses sqlite. For Redis vs PostgreSQL guidance, see Persistence Backends.

pip install upnext
UPNEXT_BACKEND=sqlite \
UPNEXT_DATABASE_URL=sqlite+aiosqlite:///upnext.db \
UPNEXT_REDIS_URL=redis://localhost:6379 \
upnext server start --port 8080

# Connect workers/APIs to the server
UPNEXT_REDIS_URL=redis://localhost:6379 \
UPNEXT_URL=http://localhost:8080 \
upnext run service.py

Get started

Installation

Install UpNext and its prerequisites.

Quickstart

Build and run your first worker + API in 5 minutes.

Learn more

Concepts

Understand how workers, tasks, events, and APIs work.

Guides

Practical how-to guides for common workflows.

Dashboard

Set up and use the real-time monitoring dashboard.

Installation

Get Started

​Two ways to run

​Get started

Installation

Quickstart

​Learn more

Concepts

Guides

Dashboard

Two ways to run

Get started

Learn more