Installation — papagai 0.1.0 documentation

# Installation

## Requirements

- Python 3.10 or later

- Git

- Optional: `fuse-overlayfs` for overlay filesystem worktree isolation

## Installing from Source

Install directly from GitHub using pip:

    $ pip install https://github.com/whot/papagai

## Development Installation

For development, clone the repository and use uv:

    $ git clone https://github.com/whot/papagai
    $ cd papagai
    $ uv run papagai --help

## Optional Dependencies

### Rich Logging

For enhanced console output with rich formatting, install the `rich` package:

    $ pip install rich

### Overlay Filesystem Support

For overlay filesystem worktree isolation, install `fuse-overlayfs`:

On Fedora/RHEL:

    $ sudo dnf install fuse-overlayfs

On Ubuntu/Debian:

    $ sudo apt install fuse-overlayfs

## Verifying Installation

After installation, verify that papagai is working:

    $ papagai --help

You should see the help message with available commands.