---
id: doit
version: "0.37.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# doit — doit - Automation Tool

License: permissive · Maintenance: aging · Downloads: 856.5K/mo

## What it is and what it does

doit is a task automation tool written in pure Python that replaces shell-based build systems like make. You define tasks as Python functions in a dodo.py file, specifying file dependencies, targets, and actions. doit tracks which files have changed and skips tasks that are already up-to-date, running only the work that matters. It handles task ordering automatically via dependency resolution, supports parallel execution of independent tasks, and lets you generate tasks dynamically or compute dependencies at runtime—all without a domain-specific language or configuration files.

The tool is designed for developers, system administrators, and researchers who need reproducible, efficient build pipelines. It works across Python 3.10 through 3.13 and has no external runtime dependencies, making it lightweight to install and integrate into existing Python projects.

Use it for:

- Build and test pipelines that should skip unchanged components to save time in CI/CD workflows.
- Scientific computing workflows where intermediate results are cached and reused across experiment runs.
- Documentation generation that regenerates only modified source files and their dependents.
- Data processing pipelines with complex interdependencies between stages.
- Automation of repetitive development tasks like code generation, linting, and deployment steps.

## Worth the install?

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

doit is a Python-based task automation and build tool that tracks file dependencies, caches results, and runs only tasks whose inputs have changed, eliminating redundant work in build pipelines and automation workflows.

Yes. doit is stable (Production/Stable status since 2008), has no security vulnerabilities, installs with zero friction, and solves a real problem—incremental task execution—that shell-based build systems handle poorly. The aging maintenance status is not concerning given the project's maturity and recent activity. Install it if you need efficient, Python-native task automation.

## Install

pip install doit
uv add doit
poetry add doit

## Installing doit

Before you install: Low install friction with no runtime dependencies. Maintenance status is aging—last release was 186 days ago—but the project remains active with recent commits and a stable codebase.

License in practice: MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions; attribution is required but no copyleft obligations apply.

Quickstart:

pip install doit

Create dodo.py:
  def task_hello():
      return {
          'actions': ['echo "Hello from doit" > hello.txt'],
          'targets': ['hello.txt'],
          'clean': True,
      }

Run: doit

Requires Python 3.10 or later.

Verify before relying:

- Whether the plugin architecture and extensibility model are documented well enough for typical use cases.
- Performance characteristics when running hundreds or thousands of tasks in parallel.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 856.5K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python task runner, build automation tool, incremental build system, file dependency tracking, make alternative python, task pipeline automation, parallel task execution, build-automation, task-runner, incremental-builds

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