Neurocontainers Builder

Neurocontainers repository is used for automatic building and testing of containers available in Neurodesktop

A Tutorial on how to add new applications to NeuroDesk is here: How to Add new tools

Information on the Neurodesk project is available at neurodesk.org

Information on Neurocontainers is available at neurodesk.org/docs/neurocontainers

Working in this repository

python3.13 -m venv env && source env/bin/activate
pip install -r requirements.txt && pip install -e .

sf-init <name> <version>    # Scaffold a new recipe in recipes/<name>/
sf-build <name>             # Generate the Dockerfile and build the image
sf-test <name>              # Run the recipe's fulltest.yaml

pytest builder/tests        # Builder and workflow unit tests
./workflows/test_all.sh     # Validate and generate every recipe

• CONTRIBUTING.md — how to propose a change
• AGENTS.md — recipe format, conventions, and common tasks
• builder/README.md — the build system and full recipe syntax
• workflows/TESTING.md — how container tests run locally and in CI