---
id: robocorp-tasks
version: "4.1.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# robocorp-tasks — The automation framework for Python

License: permissive · Maintenance: active · Downloads: 335.6K/mo

## What it is and what it does

robocorp-tasks is a Python framework that standardizes how you write and run automation scripts. Instead of ad-hoc scripts, you decorate functions with @task and run them through a managed runner that handles logging, lifecycle events, and result capture automatically. The framework integrates robocorp-log to provide detailed execution traces—method calls, arguments, variable assignments—and outputs structured logs to HTML for post-execution analysis.

You define tasks as parameterless functions decorated with @task, then invoke them via command line (python -m robocorp.tasks run <path> -t <task_name>). The runner discovers tasks from files matching *task*.py patterns, manages one task per invocation, and produces an output/log.html report. It's designed for teams building multiple automation projects who need consistency, observability, and maintainability across different codebases.

Use it for:

- Build repeatable RPA workflows with automatic detailed logging and HTML result reports.
- Standardize task structure across a team's automation projects to reduce ad-hoc script sprawl.
- Debug automation failures by reviewing structured execution logs showing all method calls and state changes.
- Integrate Python automations into CI/CD pipelines with a consistent command-line interface.
- Set up and tear down test environments or data pipelines with lifecycle-managed task execution.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

robocorp-tasks is a Python framework for building and running automation tasks with built-in logging and lifecycle management, using a simple decorator-based API.

Yes. robocorp-tasks is production-stable, actively maintained, has low install friction, carries no known vulnerabilities, and solves a real problem—replacing ad-hoc automation scripts with a structured, observable framework. It's particularly valuable if you're building multiple automation projects or need detailed execution logging for debugging and compliance. The Apache-2.0 license poses no restrictions.

## Install

pip install robocorp-tasks
uv add robocorp-tasks
poetry add robocorp-tasks

## Installing robocorp-tasks

Before you install: Low install friction with a pure-wheel distribution. The package is actively maintained with a recent commit on 2026-07-24 and carries production-stable status. Four runtime dependencies are all common utilities (packaging, psutil, docstring_parser_fork, robocorp-log), suggesting a straightforward integration.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for most automation projects without licensing concerns.

Quickstart:

pip install robocorp-tasks

from robocorp.tasks import task

@task
def my_task():
    print('Running automation')

# Run via: python -m robocorp.tasks run <file.py> -t my_task

Requires Python 3.10 or later (supports up to 3.14).

Verify before relying:

- Whether robocorp-log dependency brings additional system requirements or native bindings that could affect portability.
- Performance characteristics when running many tasks or long-running automations.
- Integration patterns with existing CI/CD systems beyond the command-line interface.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 335.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python automation framework, task runner with logging, robotic process automation python, structured task execution, automation task decorator, python task runner, automation logging framework, automation, task-runner, rpa

[View on SkillFed](https://skillfed.io/packages/robocorp-tasks) · [View on PyPI](https://pypi.org/project/robocorp-tasks/)