what is software-mri fr?

ishaan-sharma-tech/software-mri — explained in plain English

Analysis updated 2026-05-18

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

vibe map

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

what do people make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

what's the stack?

JavaScriptElectronThree.jstree-sitterNode.js

how it stacks up fr

	ishaan-sharma-tech/software-mri	abhishek-kumar09/test	acip/slack-claude-agent
Stars	1	1	1
Language	JavaScript	JavaScript	JavaScript
Last pushed	—	2023-05-29	—
Maintenance	—	Dormant	—
Setup difficulty	easy	easy	moderate
Complexity	2/5	1/5	3/5
Audience	developer	ops devops	developer

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

how do i run it?

Difficulty · easy time til it works · 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.

prompts (copy fr)

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