This project is no longer developed on GitHub and has been migrated to Codeberg:
https://codeberg.org/psyinfra/onyo
Onyo is a text-based inventory system built on top of git. It uses the filesystem as the index and git to track history. This allows much of Onyo's functionality to be just a thin wrapper around git commands.
See the documentation for installation instructions and general information about Onyo.
Onyo requires Python >= 3.13 and a few system utilities.
Debian/Ubuntu:
apt-get install git tig python3-pip
macOS:
brew install git tig
python3 -m venv ~/.venvs/onyo
source ~/.venvs/onyo/bin/activate
Enabling tab-completion is also recommended:
source <(onyo shell-completion)
An example Onyo repository is available. It's easier to get a feel for how Onyo works with a populated repository with actual history, rather than starting from scratch. Just install Onyo, clone the demo repo, and start poking around!
For general feedback, bug reports, and comments, please open an issue.