Running GRANA on your local machine

Installing via Docker Container

The recommended method for running GRANA is through a Docker container. If Docker is already installed on your system, simply enter the following command in your Terminal:

docker run -p 7860:7860 mbuk/grana

Once the command is executed, you can access the GRANA interface in your browser at http://localhost:7860.

If you’re new to Docker

Refer to the Docker Desktop official documentation for detailed installation steps based on your operating system.

• Windows (WSL): The quickest way to set up GRANA on Windows is to install Docker Desktop with Windows Subsystem for Linux (WSL) 2 enabled. Start by installing WSL following Microsoft documentation. Then, use Docker's official WSL documentation for Docker Desktop setup. Once Docker is running, execute the Docker container installation command provided above.
• macOS:Download and install Docker Desktop for macOS. After launching Docker Desktop, you can run the installation command directly from the Terminal.
• Linux: Follow the installation guide on Docker's website for your Linux distribution.

Additional Resources

• Documentation: The GRANA GitHub repository contains the source code and documentation.
• Demo Dataset: Try GRANA with a set of Demo Images available here. We encourage you to test GRANA with your own TEM images. Detailed guidance on best practices for microscopy imaging to ensure efficient and reliable analysis with the GRANA tool can be found in the reference paper and Supplementary Figure 2. For best results, use well-contrasted TEM micrographs with clearly visible grana structures. Avoid images showing entire chloroplasts, as grana may appear too small for accurate structural analysis due to limited layer and lumen visibility.

For additional support, refer to the README on the GitHub repository, and follow the documentation links for troubleshooting and usage tips.