MAGI - Modular Assignment Generator & Inspector

Description

MAGI is a python framework for generating programming assignments and autograders for Gradescope, with extensible modules and plugins.

Platform/Architecture	Status
Windows	Supported
macOS	Supported
Linux	Supported
x86	Supported
x64	Supported
ARM	Supported with limited feature

---

Documentation

For detailed documentation, please visit our GitHub Wiki.

Quick Start

The easiest way to get started with our application is by using our pre-built Docker image.

docker run -d --name magi --tmpfs /app/output,/app/workdir,/app/webui/pages -v ./settings:/app/settings -p 8501:8501 ghcr.io/cics-syslab/magi:latest

Docker Compose

version: '3'

services:
  magi:
    container_name: magi
    image: ghcr.io/cics-syslab/magi:latest
    tmpfs:
      - /app/output
      - /app/workdir
      - /app/webui/pages
    volumes:
      - ./settings:/app/settings
    network_mode: bridge
    ports:
      - "8501:8501"

Building from Source

If you prefer to build the application from source, follow the instructions in the Build.

Usage

Access the web interface through http://host:port

For detailed usage instructions, please refer to Usage.

Contributing

We welcome contributions! Please check out our Contributing page for guidelines.

---

Support & Feedback

For support or to provide feedback, please raise an issue on our GitHub repository.

---

License

MAGI is released under the MIT License.

---

Acknowledgments

Special thanks to the community and everyone who contributed to making this project possible.

---

Changelog

For a detailed changelog, refer to Changelog.

---