Skip to content
/ magie Public

Analyse gigapixel images, annotated with millions of geometries, using a modern, highly-performant web interface. Built using Rust.

License

Notifications You must be signed in to change notification settings

nmzein/magie

Repository files navigation

MAGIE [alpha]

MAGIE (Massively Annotated Gigapixel Image Explorer) is a web application and backend server for rendering and displaying multi-gigapixel images & millions of annotations.

Demo Image 1 Demo Image 2

Features

  • ⚡️ Extremely performant Rust backend and Svelte frontend, utilising WebGL to render hundreds of thousands of annotations in milliseconds.

  • 🖥️ Sleek and modern user interface.

  • 🗂️ Remotely access your library using a fully-featured file explorer.

  • 🛠️ Easily integrate your own image decoders, encoders, and analysis tools using a powerful, flexible module interface.

  • 🌐 Accessible anywhere at any time using any modern web browser.


💽 Installation

  1. Download the source code: git clone https://github.com/nmzein/magie.git
  2. Navigate to main directory: cd magie

Docker (recommended)

  1. Install Docker Engine.
  2. Ensure the Docker daemon is running.
  3. Run the following commands (note that you may need to run them with sudo):
🛠️ Production [1.25GB]
docker compose up prod

🏗️ Development [1.43GB]
docker compose up --build dev

The application can now be accessed at http://0.0.0.0:4000.


Bare Metal

Install dependencies:

OS Command Verified Supported Version(s)
Debian ./install.sh debian 12
Fedora ./install.sh fedora 40, 41
Ubuntu ./install.sh ubuntu -

Build and run:

🛠️ Production
./build.sh prod
./run.sh prod

🏗️ Development
./build.sh dev
./run.sh dev

The application can now be accessed at http://localhost:4000.