ishaan-sharma-tech/software-mri

Analysis updated 2026-05-18

★ 1JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((Software MRI))
    What it does
      3D codebase map
      Problem detection
      Local AI queries
    Problems it flags
      Circular dependencies
      Large files
      High complexity
    Tech used
      Electron
      Three.js
      tree-sitter
      Qwen2.5 Coder
    Getting started
      Download exe
      Drag in folder
      Explore 3D view
    Audience
      New team members
      Refactor planners
      Architecture reviewers

mindmap root((Software MRI)) What it does 3D codebase map Problem detection Local AI queries Problems it flags Circular dependencies Large files High complexity Tech used Electron Three.js tree-sitter Qwen2.5 Coder Getting started Download exe Drag in folder Explore 3D view Audience New team members Refactor planners Architecture reviewers

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Open a large unfamiliar codebase and immediately see its file structure and dependency layout in 3D to get oriented quickly.

USE CASE 2

Scan a project for circular dependencies and complexity hotspots before planning a refactor, without reading code manually.

USE CASE 3

Ask the built-in local AI questions about the code structure and get answers without an internet connection or API key.

What is it built with?

JavaScriptElectronThree.jstree-sitterNode.js

How does it compare?

	ishaan-sharma-tech/software-mri	acip/slack-claude-agent	alexanderdaly/neurofhe-relay
Stars	1	1	1
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	easy	moderate	easy
Complexity	2/5	3/5	2/5
Audience	developer	developer	researcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Windows only for now, Mac and Linux builds are on the roadmap. Download the .exe installer from the releases page.

MIT license, meaning you can use, modify, and distribute it freely for any purpose including commercial projects.

In plain English

Software MRI is a desktop application for Windows that turns a code project into an interactive 3D visualization. Instead of reading through hundreds of text files to understand how a software project is organized, you drag a folder into the app and see all the files appear as nodes in a three-dimensional space, with lines drawn between them based on how they depend on each other. The tool is aimed at developers who join a large project and need to build a mental map of how it is structured, or who are planning major changes and want to see where complexity is concentrated before touching anything. The 3D view can handle repositories with more than 5,000 files while staying smooth and responsive. Software MRI includes automatic problem detection. It flags circular dependencies, which happen when two parts of the code each rely on the other in a loop and can cause hard-to-trace bugs. It also highlights extremely large files and sections with high logical complexity. These appear visually in the 3D view with distinct indicators so the problems are immediately visible without manual code review. The app also includes a local AI assistant that runs entirely on your own computer. You can ask it questions about the code structure and it responds without sending anything to the internet. No account, no API key, and no cloud access required. The embedded model is Qwen2.5-Coder. Under the hood, the app is built with Electron, which packages web technologies into a desktop program. It uses tree-sitter to parse and understand more than 300 programming languages, and Three.js to render the 3D visualization. Installation is a single Windows .exe file that takes a few seconds to run. Mac and Linux support are listed as future plans. The project is licensed under MIT.

Copy-paste prompts

Prompt 1

Using Software MRI, I loaded a 2000-file JavaScript project. How do I interpret the glowing red nodes, and what does a circular dependency look like in the 3D view?

Prompt 2

I want to contribute to Software MRI and improve the Three.js LOD shaders. Walk me through the renderer architecture based on the CONTRIBUTING.md.

Prompt 3

How does Software MRI use tree-sitter to extract import and export relationships from Python files? Explain the parsing step in plain terms.

Prompt 4

I want to build Software MRI from source on Windows. Walk me through the npm ci and npm run dev steps and what the dev environment looks like.

Prompt 5

Using the local AI in Software MRI, ask it to explain why file X has high cyclomatic complexity and suggest which functions to split first.

Frequently asked questions

What is software-mri?

A Windows desktop app that renders your codebase as a 3D map of files and connections, automatically flagging circular dependencies and complexity hotspots with a built-in local AI assistant.

What language is software-mri written in?

Mainly JavaScript. The stack also includes JavaScript, Electron, Three.js.

What license does software-mri use?

MIT license, meaning you can use, modify, and distribute it freely for any purpose including commercial projects.

How hard is software-mri to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is software-mri for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ishaan-sharma-tech on gitmyhub

Verify against the repo before relying on details.