Installation¶

This guide covers how to install janito.

From PyPI¶

The easiest way to install janito is from PyPI:

pip install janito

Or, with uv (recommended):

uv tool install janito

From Source¶

For development or the latest features, install from source:

Prerequisites¶

• Python 3.10+
• Git
• uv (project & package manager)
• GitHub CLI (optional)

Clone and Install¶

# Clone the repository
git clone https://github.com/ikignosis/janito.git
cd janito

# Create the virtual environment and install the project + dev dependencies
uv sync

uv sync installs janito in editable mode by default and installs the dev dependency group. An editable install means your source-code changes take effect immediately without reinstalling (the equivalent of pip install -e .). To also install the documentation tooling:

uv sync --group docs

Running Without Installation¶

You can also run janito directly from the synced environment:

uv run python -m janito "Your prompt here"

Verify Installation¶

Check that janito is installed correctly:

uv run janito --version

Or run the help command:

uv run janito --help

Dependencies¶

janito requires the following dependencies:

These are automatically installed when you install janito.

System Requirements¶

• Operating System: Windows, macOS, Linux
• Python: 3.10, 3.11, 3.12, 3.13, 3.14
• Terminal: Any modern terminal (PowerShell, Bash, Zsh, etc.)

Next Steps¶

Now that janito is installed, head to the Quick Start guide to configure and run your first prompt.