Setup Guide
Get the Makoto demos running in under 5 minutes
1
Install git
Git is required to clone the Makoto repository. Most systems already have it installed.
macOS
Linux
Windows
$ brew install git
$ sudo apt install git
Download and install from git-scm.com
2
Install uv
uv is a fast Python package manager that handles virtual environments and Python version selection automatically. All Makoto demos use uv.
macOS / Linux
Windows
$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ source $HOME/.local/bin/env
> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Verify the installation:
$ uv --version
uv 0.5.x
3
Clone the repo
Clone the Makoto repository from GitHub.
$ git clone https://github.com/makoto-project/makoto
$ cd makoto
4
Run your first demo
Try the AI Dataset Verification demo to see Makoto in action.
$ cd demos/05-ai-dataset-verification
$ uv run demo.py
Why uv? uv automatically handles virtual environments and Python version selection. All Makoto demos use Python stdlib only —
uv run works with zero extra configuration.
Troubleshooting
uv: command not found
Restart your terminal, or run: source $HOME/.local/bin/env
bash: run.sh: Permission denied
Run: chmod +x run.sh
Wrong Python version
uv automatically selects Python 3.8+, no action needed.
Next Steps
You're all set. Pick a demo and see Makoto in action: