Skip to content

🌌 GitGalaxy Documentation

Code is art. Logic is art. Systems engineering is art.

GitGalaxy is a high-velocity, deterministic function-level knowledge graph engine designed for planetary-scale codebases.

While the project is widely recognized for its interactive 3D WebGL visualizer—which renders repositories as explorable galaxies—this visualizer is ultimately just a presentation layer. The true core of the project is the blAST Engine (Bypassing LLMs and ASTs): a polyglot structural physics engine that extracts the architectural heuristics of 50+ languages simultaneously without requiring compilation.

🧭 Where should I start?

GitGalaxy is a massive ecosystem. Choose your entry point based on your operational domain:

🛡️ For Enterprise Architects & DevSecOps

If you are looking to secure supply chains, audit AI agents, and generate compliance artifacts, start here: * 📜 The SHBOM Standard (Structural Health Bill of Materials) * 🤖 Autonomous AI Guardrails (Dev Agent Firewall) * ⏱️ The Continuous Delta Paradigm (CI/CD Integration) * 🗄️ Cookbook: Enforce a Zero-Trust Supply Chain Firewall

🏦 For Legacy Modernization Teams

If you are tasked with breaking apart 40-year-old IBM monoliths without using an emulator: * 🌉 The Legacy Bridge (Mainframe Modernization Philosophy) * 🕸️ The DAG Architect (Topological Execution Mapping) * ☕ Cookbook: Refactoring COBOL into Spring Boot

⚙️ For Systems Engineers (The Physics & Proofs)

If you want to understand the mathematics driving the engine and the empirical proofs that validate our AST-free approach: * 🔬 The blAST Paradigm (Heuristics vs. ASTs vs. LLMs) * ⚖️ Claim 10: The Heuristic vs. AST Paradigm * 🛡️ Claim 8: Empirical Validation of AST-Free Parsing (The Gauntlets) * 📐 The 13-Point Risk Exposure Equations

⚙️ The Hub and Spoke Ecosystem

1. The Hub: The blAST Engine (GalaxyScope)

A hyper-scale, language-agnostic static analysis CLI. Bypassing traditional ASTs, it parses code at ~100,000 LOC/second using deterministic regular expressions and a multi-phase Physics Engine. It outputs rich JSON telemetry, SQLite databases, and low-token Markdown briefs optimized for AI-agent workflows.

2. The Spokes: Enterprise Operations

The core engine powers a massive ecosystem of specialized tools: * Legacy Modernization: Automated pipelines to map, slice, and refactor legacy COBOL into modern Java microservices. * Security & Auditing: Zero-trust firewalls that verify physical dependencies, hunt Shadow APIs, and perform Binary X-Rays. * AI Governance: Threat sensors designed to hunt RCE Funnels, God-Mode Agents, and Context Window Shredders.

3. The Presentation: The Observatory

Drop your _galaxy.json into the free viewer at GitGalaxy.io or use the repo's airgap_observatory, a standalone WebGPU visualizer. Both visualizers read the JSON contract and render the entire codebase as a procedural 3D galaxy where files are stars, allowing humans to visually map scale and risk exposure instantly.

📚 Master Documentation Index

Core Concepts & Claims

Pipeline & Architecture

Security & Threat Intelligence

Legacy Mainframe Refraction

Mathematical Physics (3D Geometry)

Mathematical Physics (Risk Exposures)

🗄️ The Cookbook (Applied Use Cases)

Legacy Modernization Cookbooks

🚀 Quickstart

1. Install 

pip install gitgalaxy

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. 

galaxyscope /path/to/your/local/repo

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.

🔒 Zero-Trust Architecture

Whether you are running the command-line engine or the WebGL visualizer, GitGalaxy operates on a strict Zero-Trust Privacy Model: Your code never leaves your computer.

  • No Data Transmission: Source code is never transmitted to any API, cloud database, or third-party LLM service.
  • Air-Gap Ready: The entire suite of tools is designed to run in highly secure, internet-disconnected environments.
  • Ephemeral Memory Processing: Repositories are unpacked into a volatile memory buffer and are automatically purged when the operation completes.



🌌 Powered by the blAST Engine

This documentation is part of the GitGalaxy Ecosystem, an AST-free, LLM-free heuristic knowledge graph engine.