constellab/glab repository overview

⁠👋 Welcome to Glab

glab is a Constellab⁠ container developped by Gencovery⁠. It installs the Constellab bricks in the lab and then runs the python api.

⁠🚀 What is Constellab?

✨ Gencovery⁠ is a software company that offers Constellab⁠., the leading open and secure digital infrastructure designed to consolidate data and unlock its full potential in the life sciences industry. Gencovery's mission is to provide universal access to data to enhance people's health and well-being.

🌍 With our Fair Open Access offer, you can use Constellab for free. Sign up here⁠. Find more information about the Open Access offer here (link to be defined).

⁠✅ Features

This container is installed and runned by the lab-manager⁠. It installs the bricks of the data lab, then run the api.

To view more information about the lab architecture here⁠

⁠📄 Documentation

📄 For gws_core brick documentation, click here⁠

💫 For Constellab application documentation, click here⁠

⁠🛠️ Installation

To run this container, you need to run the lab-manager⁠ container first.

Then from Constellab⁠ space, you can configure your lab and run the glab.

⁠🧪 Run modes

The container picks what to run after init_all based on the RUN_MODE env var:

In test mode:

• TEST_BRICK_NAME — brick whose tests are run (required).
• TEST_PARALLEL — true (default) uses test-parallel; false uses test for single-threaded execution.

The container exits with the test command's exit code — suitable for CI fan-out across bricks. A MariaDB instance must be reachable via the brick's usual GWS_TEST_DB_* env vars; the image does not provision it.

⁠🔐 SSH access (optional)

The image ships an SSH server (port 2222, labuser only, public-key authentication only) but does not start it by default. It is controlled by a single env var:

The container has no init system, so /init-lab/init-ssh.sh — run by the entrypoint — is the only thing that can start sshd. With the flag off there is no SSH surface to attack.

To use it, enable the flag, publish port 2222 and add the client public key to /home/labuser/.ssh/authorized_keys. Host keys are deliberately not baked into the image, so each container has its own identity.

The codelab image sets ENABLE_SSH_SERVER=true by default because VS Code Remote SSH is one of its features; set it to false at runtime to turn that off.

⁠🤗 Community

🌍 Join the Constellab community here⁠ to share and explore stories, code snippets and bricks with other users.

🚩 Feel free to open an issue if you have any question or suggestion.

☎️ If you have any questions or suggestions, please feel free to contact us through our website: Constellab⁠.

⁠🌎 License

glab is completely free and open-source and licensed under the GNU General Public License v3.0⁠.

This brick is maintained with ❤️ by Gencovery⁠.