Installation

Non-Python Dependencies

In addition to Python >= 3.11 and a few Python modules, Onyo depends on a few system utilities.

Debian/Ubuntu:

apt-get install git tig python3-pip

macOS:

brew install git tig

Onyo

To install Onyo, run the following from your command line:

pip3 install git+https://github.com/psyinfra/onyo.git

Enabling tab-completion is also recommended: .. code:

source <(onyo shell-completion)

Add the above line to your shell’s config file (e.g. ~/.zshrc) to make it persistent.

Aliases

If you have an Onyo repository and you want to be able to operate on it from anywhere on the system, set an alias passing -C. For example, for Bourne shells:

alias onyo='onyo -C path/to/repo'

Or for multiple repos:

alias onyo-home='onyo -C path/to/home.repo'
alias onyo-corp='onyo -C path/to/corp.repo'

The same technique can be used to invoke git on an Onyo repo from anywhere on the system:

alias onyo-git='git -C path/to/repo'

Add aliases to your shell’s config file (e.g. ~/.bashrc or ~/.zshrc) to make them persistent.