Installation
Requirements
Python 3.10 or later
Git
Optional:
fuse-overlayfsfor 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.