Welcome to Genesis Core!

The Genesis Core is an open source software that offers a one turnkey solution to deal with infrastructure at all levels - from bare metal and virtual machines to applications and services.

Refer to the wiki for more detailed information.

📦 Installation

There are several ways to install Genesis Core and depend on your purpose you can choose one of them.

Try it out

If you want to try Genesis Core in a few minutes, download the all-in-one stand. It's a ready-to-go virtual machine image with preinstalled Genesis Core and ability to get full functionality such as creating inner(nested) virtual machines, installation elements and many others. This stand may be used for development purposes as well if you are focusing on a new element development.

Basic usage

In a case you would like to run Genesis Core on your own infrastructure, you can use the basic guide for more details.

🚀 Development

Ubuntu:

sudo apt-get install build-essential python3.12-dev python3.12-venv \
    libev-dev libvirt-dev curl
curl -LsSf https://astral.sh/uv/install.sh | sh
source "$HOME"/.local/bin/env
uv tool install tox --with tox-uv

Fedora:

sudo dnf install gcc libev-devel libvirt-devel curl
curl -LsSf https://astral.sh/uv/install.sh | sh
source "$HOME"/.local/bin/env
uv tool install tox --with tox-uv 

Initialize virtual environment:

tox -e develop
source .tox/develop/bin/activate

Follow the development guide here for more details.

⚙️ Tests

NOTE: Python version 3.12 is supposed to be used, but you can use other versions

# Unit tests
tox -e py312

# Functional tests
tox -e py312-functional

Functional tests environment

To run functional tests, export the following environment variables:

export DATABASE_URI="postgresql://genesis_core:genesis_core@127.0.0.1:5432/genesis_core"
export ADMIN_PASSWORD="admin"
export DEFAULT_CLIENT_SECRET="GenesisCoreSecret"
export GLOBAL_SALT="FOy/2kwwdn0ig1QOq7cestqe"
export HS256_KEY="secret"

🔗 Related projects

• Genesis SDK is a set of tools for developing Genesis elements. You can find it here.
• Genesis DevTools it's a set oftools to manager life cycle of genesis projects. You can find it here.

💡 Contributing

Contributing to the project is highly appreciated! However, some rules should be followed for successful inclusion of new changes in the project:

• All changes should be done in a separate branch.
• Changes should include not only new functionality or bug fixes, but also tests for the new code.
• After the changes are completed and tested, a Pull Request should be created with a clear description of the new functionality. And add one of the project maintainers as a reviewer.
• Changes can be merged only after receiving an approve from one of the project maintainers.