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.