██████╗ ██████╗  █████╗ ██╗███╗   ██╗    ████████╗ ██████╗     ██████╗ ██╗   ██╗████████╗███████╗███████╗
██╔══██╗██╔══██╗██╔══██╗██║████╗  ██║    ╚══██╔══╝██╔═══██╗    ██╔══██╗╚██╗ ██╔╝╚══██╔══╝██╔════╝██╔════╝
██████╔╝██████╔╝███████║██║██╔██╗ ██║       ██║   ██║   ██║    ██████╔╝ ╚████╔╝    ██║   █████╗  ███████╗
██╔══██╗██╔══██╗██╔══██║██║██║╚██╗██║       ██║   ██║   ██║    ██╔══██╗  ╚██╔╝     ██║   ██╔══╝  ╚════██║
██████╔╝██║  ██║██║  ██║██║██║ ╚████║       ██║   ╚██████╔╝    ██████╔╝   ██║      ██║   ███████╗███████║
╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝       ╚═╝    ╚═════╝     ╚═════╝    ╚═╝      ╚═╝   ╚══════╝╚══════╝

MEGATON v0.0.1

A simple UI for NVIDIA SMI, we did not make nvidia-smi please check out NVIDIA-Smi nvidia webpage. Megaton is 100% OPEN-SOURCE and free!

Description

Simple lightweight UI for nvidia-smi that can be run as docker containers (back and front end) or locally. Megaton allows for temperature and GPU information monitoring in real time. It will detect automatically your video cards and pick up the info from nvidia-smi.

System Requirements & Dependencies

• Nvidia Enterprise Video Cards compatible with nvidia-smi
• nvidia-smi installed
• nvidia-container-toolkit
• Up to date nvidia drivers
• Docker
• Python 3.12 (if running outside a docker container)

This is not compatible with ARM with these docker files, if you want to make it compatible with ARM please feel free to fork or clone and change the docker image

• Ubuntu download nvidia drivers (this should install nvidia-smi)
• NVIDIA-Smi documentation
• Nvidia container toolkit

Installation

Container based

1. Check system requirements
2. Clone this repo
3. Modify megaton_configs/megaton_config.json and add your internal IP_ADDRESS

{
    "ip_address": "YOUR_INTERNAL_IP_ADDRESS"
}

4. In docker compose change the following to the amount of video cards you have

    - driver: nvidia
      count: your_gpu_count

5. docker compose up -d
6. In your webbrowser your_ip_address:5279 for the ui
7. (Optional) Change docker ports in the docker-compose.yaml file
8. (Optional) Check out the swagger UI for additional API's at: your_ip_address:5278/documentation
9. (Optional) Check out the swagger logs at: your_ip_address:5278/logs 10.(Optional) Check out the about page in Megaton or our webpage at braintobytes

Available APIs

• Get cards information (all)
• Get temperature information
• Get gpu memory information
• Get gpu usage information
• Get version
• Health check

Available Websockets

• Get cards information (all)
• Get temperature information
• Get gpu memory information
• Get gpu usage information

❤️ WE LOVE FEEDBACK! ❤️

Please report any bugs or issues you find on in the issue tab of this repository.

🧠🛸 HELP US GROW! 🛸🧠

Fork the project and help us throw more code in the pot!

🚀🌌🛰️👾 CONTRIBUTING GUIDELINES 👾🛰️🌌🚀

To contribute, help us grow, or give feedback here are the contributing guidelines!

Check out our website, braintobytes.com for more!