GitGalaxy Documentation
Code is art. Logic is art. Systems engineering is art.
GitGalaxy is a two-part ecosystem connected by a universal JSON contract. It is designed to extract the structural DNA of massive software repositories and render their non-visual architecture into measurable, explorable 3D galaxies.
1. The blAST Engine - The GalaxyScope (Backend)
A hyper-scale, language-agnostic static analysis CLI. Based on 50 years of bioinformatics and genetic sequencing algorithms, it parses code at ~100,000 LOC/second. It outputs rich JSON telemetry, SQLite databases, and low-token Markdown briefs optimized for AI-agent workflows.
2. The Observatory (Frontend)
Drop your galaxy.json into the free viewer at GitGalaxy.io or use the repo's airgap_observatory, a standalone, zero-telemetry WebGPU visualizer. Both visualizers read the JSON contract and render the entire code base as a procedural 3D galaxy where files are stars, allowing humans to visually map scale and risk exposure instantly.
🚀 Quickstart
1. Install
2. Scan a Repository Point the GalaxyScope at any local repository or ZIP archive. The engine runs entirely on your local machine—zero data is transmitted.
3. View the Galaxy
GitGalaxy offers two ways to visualize your 3D architecture, both built on a strict Zero-Trust Privacy Model where your code never leaves your machine.
* The Web Viewer (Frictionless): Drag and drop your generated _galaxy.json file directly into GitGalaxy.io. All rendering and scanning happens entirely in your browser's local memory.
* The Local Server (Enterprise & Offline): For teams operating under strict compliance rules, GitGalaxy includes a 100% static, zero-telemetry local viewer called the Airgap Observatory.
🧬 The blAST Paradigm: Sequencing the DNA of Software
Traditional computer science treats software like a rigid blueprint, using slow, language-specific Abstract Syntax Trees (ASTs) to analyze code. GitGalaxy treats code as a living, mutating organism using blAST (Broad Lexical Abstract Syntax Tracker).
By applying the principles of biological sequence alignment to software, blAST hunts for the universal structural markers of logic across ~40 languages and ~250 file extensions. We translate this genetic code into "phenotypes"—measurable risk exposures.
Zero-Trust Architecture
Your code never leaves your machine. GitGalaxy performs 100% of its scanning and vectorization locally. * No Data Transmission: Source code is never transmitted to any API, cloud database, or third-party service. * Ephemeral Memory Processing: Repositories are unpacked into a volatile memory buffer (RAM) and are automatically purged when the browser tab is closed.
The Viral Security Lens
Traditional security scanners rely on rigid, outdated virus signatures. blAST acts like an immune system, hunting for the behavioral genetic markers of a threat. By analyzing the structural density of I/O hits, execution triggers, and security bypasses, blAST is perfectly engineered to stop modern attack vectors.