Makim

License Discord

Makim is inspired by tools like Make and Ansible, focusing on improving task definition and dependency management. Instead of using the Makefile format, it utilizes YAML for defining tasks.

License: BSD 3 Clause
Documentation: Makim Docs

Features

Help Text as First-Class: Add detailed help text to tasks and arguments for clear documentation.
Task Arguments: Define and manage arguments with types, defaults, and descriptions.
Dependencies with Conditional Control: Set task dependencies with if conditionals to manage execution dynamically.
Environment Variables: Scope variables globally, by group, or by task to reduce redundancy and maintain modularity.
Jinja2 Templating: Access arguments, variables, or environment variables via Jinja2 templates.
Matrix Configuration: Automate tasks across multiple parameter combinations (ideal for CI/CD workflows).
Hooks: Use pre-run and post-run hooks to customize task lifecycles.
Scheduler: Cron-like scheduling with APScheduler integration for periodic tasks.
Remote Execution: Execute tasks on remote servers via SSH with flexible configurations.
File Logging: Log outputs to files with custom formatting and stream control.
Retry Mechanism: Adds resilience by retrying tasks that encounter errors.
Validation: Ensures .makim.yaml configurations are correct with schema validation.

How to use it

First you need to place the config file .makim.yaml in the root of your project. This is an example of a configuration file:

groups:
  build:
    env:
      GROUP_ENV: group_value
    tasks:
      clean:
        help: Clean build artifacts
        args:
          cache:
            type: bool
            action: store_true
            help: Remove all cache files
        log:
          path: ./logs/clean.txt
          level: err
          format: "%(asctime)s - %(file)s - %(levelname)s - %(message)s"
        run: |
          echo "Cleaning build directory..."
          rm -rf build/
      compile:
        help: Compile the project
        hooks:
          pre-run:
            - task: build.clean # Run 'clean' before 'compile'
        run: |
          echo "Compiling the project..."

# Scheduler for automated tasks
scheduler:
  daily-clean:
    task: build.clean
    schedule: "0 0 * * *" # Every day at midnight

Some examples of how to use it:

run the compile task: makim build.compile
run the clean task with argument: makim build.clean --cache

The help menu for the .makim.yaml file would looks like this:

$ makim --help

 Usage: makim [OPTIONS] COMMAND [ARGS]...

 Makim is a tool that helps you to organize and simplify your helper commands.

╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --version             -v            Show the version and exit                │
│ --file                        TEXT  Makim config file [default: .makim.yaml] │
│ --dry-run                           Execute the command in dry mode          │
│ --verbose                           Execute the command in verbose mode      │
│ --skip-hooks                        Skip hooks while executing the command   │
│ --install-completion                Install completion for the current       │
│                                     shell.                                   │
│ --show-completion                   Show completion for the current shell,   │
│                                     to copy it or customize the              │
│                                     installation.                            │
│ --help                              Show this message and exit.              │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ build ──────────────────────────────────────────────────────────────────────╮
│ build.clean                         Clean build artifacts                    │
│ build.compile                       Compile the project                      │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Extensions ─────────────────────────────────────────────────────────────────╮
│ cron                                Tasks Scheduler                          │
╰──────────────────────────────────────────────────────────────────────────────╯

 If you have any problem, open an issue at: https://github.com/makim-org/makim

As you can see, the help menu automatically adds information defined by all the help key, inside the .makim.yaml file.

Playground

Experience makim directly in your browser using Google Colab! Google Colab is an online platform that allows you to write, run, and share Python code through your browser. It is especially useful for machine learning, data analysis, and education.

To try makim, simply click the following link, make a copy of the notebook to your drive, and then you can modify and execute the code as needed:

Experiment with makim on Google Colab

Metadata

Release files for makim 1.29.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for makim 1.29.0
File	Size	Uploaded
makim-1.29.0.tar.gz	28.3 kB	Feb 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for makim 1.29.0
File	Interpreter	ABI	Platform	Reset
makim-1.29.0-py3-none-any.whl 30.5 kB Feb 10, 2026	Python 3	none	any	Details

Total release size: 58.8 kB

Release files / makim-1.29.0.tar.gz

Download URL	makim-1.29.0.tar.gz
Size	28.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`92575a8087be6788d354e8a8bcc9c6e02b4219ebe2e612df1cc1827b2266ee22`
BLAKE2b-256 checksum How to use checksums	`868c6215ee5827afd34f2ff695a2ae6f2f34ee37b83ffd4748f298164300de4f`
Upload date	Feb 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.3.1 CPython/3.11.14 Linux/6.11.0-1018-azure`

Release files / makim-1.29.0-py3-none-any.whl

Download URL	makim-1.29.0-py3-none-any.whl
Size	30.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9a73a105401d9f5210b890e8543c44517f9a0f8a85031a0cb1c3c6f4b88d8926`
BLAKE2b-256 checksum How to use checksums	`a6f62c837052b3d5ec69aca1ab8e72a3cd1d2d73e092c6b3a25d0b88ba247a79`
Upload date	Feb 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.3.1 CPython/3.11.14 Linux/6.11.0-1018-azure`