Introduction

What is Humrun?

Humrun lets you run small Python scripts on a schedule, without servers, containers, or setup. You paste your script, pick when it runs, and Humrun takes care of execution and notifications.

No servers. No containers. No YAML files. Just Python and a schedule.

Who is it for?

Humrun is built for developers who have small automation tasks that don't justify the overhead of a full CI/CD pipeline or container orchestration.

Common users include:

• Solo developers with side projects
• Small teams needing lightweight automation
• Anyone who's tired of maintaining a VPS just to run a cron job

Design Principles

We believe automation tools have become unnecessarily complex. Not every script needs Kubernetes. Not every job needs Airflow.

Humrun is intentionally simple:

• Write Python
• Set a schedule
• Get notified when something goes wrong

That's it. No workflows, no dependencies between jobs, no complex configuration.

When to use something else

Humrun is not the right choice if you need:

• Complex multi-step workflows with dependencies
• Sub-minute scheduling
• Heavy compute workloads
• Running containers or other languages

For those cases, consider tools like Temporal, Airflow, or a proper cloud function platform.

Getting started

If you can express it in a Python script and it runs in minutes, Humrun is probably the right tool. Ready to run your first script? Head to the Quickstart guide.