> ## Documentation Index
> Fetch the complete documentation index at: https://bakefile.wisl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> bakefile is a Python task runner with two CLIs: bake runs tasks from bakefile.py, bakefile manages the project. It is not a service or platform.
> Tasks are methods on Bakebook classes in bakefile.py, decorated with @command. Subprocesses run through self.ctx.run().
> Examples are backed by tests; copy them verbatim.
# Python task runner, Makefile alternative
> An OOP task runner. Write tasks once, reuse everywhere. Like a Makefile, but reusable and in Python.
## Why bakefile?
* **Reusable** - Makefile and Justfile work well, but reusing tasks across projects is hard. bakefile makes tasks Python class methods, so you inherit and share them like any other code.
* **Python** - Write Python instead of a DSL. Real language features, type checking, and the rest of Python's tooling. `ctx.run()` still handles normal CLI commands through subprocess.
* **Language-agnostic** - Tasks are Python, but the commands they run can target any language (Go, Rust, JS, etc.).
See the full [comparison](/getting-started/why-bakefile) against Make, Just, Task, mise, and Invoke.
## A taste
```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from bake import Bakebook, command, console
class MyBakebook(Bakebook):
@command()
def hello(self, name: str = "world"):
console.echo(f"Hello {name}!")
bakebook = MyBakebook()
```
```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bake hello --name Alice
# Hello Alice!
```
Install with pip or uv, plus the optional bakelib helpers.
Create a bakefile.py, define tasks, and run them with bake.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
## A taste
```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from bake import Bakebook, command, console
class MyBakebook(Bakebook):
@command()
def hello(self, name: str = "world"):
console.echo(f"Hello {name}!")
bakebook = MyBakebook()
```
```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bake hello --name Alice
# Hello Alice!
```