🌄 Ayllu

Ayllu is a hyper performant & hackable code forge optimized for single instance deployments. It leverages the distributed nature of Git with a variety of standards based integrations.

Ayllu might fit the following use cases well:

• A drop-in replacement for gitweb allowing you to browse your repositories locally.
• Self-hosted personal project pages with lots of customizability.
• Small to medium sized community projects.

The name Ayllu /ˈajʎu/, eye-joo is the Quechua word for the traditional form of a community in the Andes region of South America, particularly in Bolivia and Peru.

Please note that this is still a work in progress and the project’s canonical home is at ayllu-forge.org. To facilitate collaboration we have mirrors available at codeberg and sourcehut. Please feel free to use which ever platform you prefer, eventually we will import both platforms into Ayllu.

codeberg sourcehut

codeberg sourcehut

A general development channel #ayllu is available on libera.

If you’d like to run a simple demo of Ayllu you can serve a local repository with our latest container image.

# change to the repository you'd like to serve
cd hello-world
podman run --rm -ti -p 10000:10000 -v $PWD:/repo --workdir /repo registry.ayllu-forge.org/ayllu/ayllu:main
# Your repository should now be available at http://127.0.0.1:10000

See the installation section in the documentation

Ayllu is written in rust and you’ll need its compiler to build the project. Additionally you also must have the following installed on your system:

• git
• sqlx-cli
• libgit2

You can run the check_build_dependencies.sh script to verify you have all the necessary software on your system.

# check your build dependencies
scripts/check_build_dependencies.sh
# intialize the sqlite database
scripts/init_db_if_missing.sh
# install pico css
npm install
# build the project
cargo build