Quickstart

Run your first script in under a minute.

Create an account

Sign up at app.humrun.io using your email or GitHub account.

Create a script

  1. Click New Script from your dashboard
  2. Give it a name (e.g., "Check website status")
  3. Paste your Python code

Here's a simple example:

import requests

response = requests.get("https://example.com")

if response.status_code != 200:
    raise Exception(f"Site returned {response.status_code}")

print(f"Site is up! Response time: {response.elapsed.total_seconds()}s")

Set a schedule

Choose how often your script should run:

  • Every 15 minutes
  • Every hour
  • Every day at a specific time
  • Custom cron expression

For this example, select Every 15 minutes.

Enable notifications

Toggle on email notifications to get alerted when your script fails.

A script "fails" when:

  • It raises an unhandled exception
  • It times out (default: 30 seconds)
  • It exits with a non-zero code

Save and run

Click Save to create your script. It will run automatically according to your schedule.

To test it immediately, click Run now.

View results

Each run is logged with:

  • Start and end time
  • Output (stdout)
  • Errors (stderr)
  • Exit status

You can view the last 100 runs in the script's history.

Next steps