Install
We offer an easy-to-use install script to install RepoBee on your machine, as outlined in this section.
Requirements
RepoBee requires Python 3.9+ and a somewhat up-to-date version of Git (2.0+ to be on the safe side). Officially supported operating systems are Ubuntu 18.04+ and macOS, but RepoBee runs fine on most Linux distributions, and also on WSL on Windows 10. Please report any issues with operating systems and/or Git versions on the issue tracker.
Installing RepoBee
RepoBee’s install script will guide you through the installation process. It
will check that you have all necessary software and provide you with links to
relevant resources if you do not. To run the script, you need either bash
or zsh
, but it’s possible to run RepoBee from virtually any shell.
Below you’ll see the command to execute to get and execute the install script.
Note that it requires curl
to be installed.
# for bash
$ bash <(curl -s https://repobee.org/install.sh)
# for zsh
$ zsh <(curl -s https://repobee.org/install.sh)
Tab completion
RepoBee supports tab completion (aka auto completion, shell completion, etc) for
bash
and zsh
, but it must be enabled separately after installing RepoBee
by executing a script found in the install directory. The procedure differs
slightly between the two shells.
Note
This guide assumes you’ve installed RepoBee at $HOME/.repobee
. If you
don’t make an active choice saying otherwise, that’s where RepoBee is
installed. The install script also explicitly tells you where it’s
installing RepoBee. If you’ve chosen to install RepoBee in any other
directory, then you need to make the proper path substitutions in the below
instructions.
bash
For bash
, simply add the following line to your $HOME/.bashrc
file.
source "$HOME/.repobee/completion/bash_completion.sh"
zsh
For zsh
, you must make sure to enable bash completion, and then source the
completion script. The entire thing looks like so.
autoload -Uz compinit
compinit
autoload -Uz bashcompinit
bashcompinit
source "$HOME/.repobee/completion/bash_completion.sh"
Important
You should not have multiple occurrences of compinit
and
bashcompinit
in your .zshrc, they should be loaded and executed only
once. If you already have them in there, just make sure to source the
RepoBee bash completion script after compinit and bashcompinit have been
called.
Docker
If you’d rather not install RepoBee for some reason, or want to use it for automation scripts, we also offer a Docker image. For this, all you need to do is install Docker, and then follow the instructions in Using RepoBee with Docker.