Skip to content

🌌 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 heuristics of massive software repositories and render their non-visual architecture into measurable, explorable 3D galaxies based on a deterministic relational knowledge graph.

🧭 Where should I start?

For Enterprise Architects & DevSecOps

If you are looking to solve immediate, multi-million-dollar infrastructure problems, start with our Enterprise Cookbook. It provides copy-paste GitGalaxy recipes for: * 🛡️ Enforcing a Zero-Trust Supply Chain Firewall * 🤖 Sandboxing Autonomous AI Coding Agents * 🏦 Refactoring Legacy COBOL into Spring Boot * 🕵️ Hunting PII Leaks in Terabyte Logs

For Systems Engineers & Developers

If you want to understand the mathematics and physics driving the GitGalaxy engine, dive into the core architecture: * 🔭 The Optical Pipeline & Aperture Filter * 📐 The 13-Point Risk Exposure Equations * 🧠 The Neural Auditor (K-Means Clustering)

⚙️ The Core Ecosystem

1. The blAST Engine - The GalaxyScope (Backend)

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 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 codebase as a procedural 3D galaxy where files are stars, allowing humans to visually map scale and risk exposure instantly.

🚀 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.

🔭 The blAST Paradigm: Deterministic Structural Heuristics

Traditional computer science treats software like a rigid blueprint, using slow, language-specific Abstract Syntax Trees (ASTs) to analyze code. GitGalaxy treats code files as raw structural text using blAST (Bypassing LLMs and ASTs).

By hunting for the universal structural markers of logic across ~50 languages and ~250 file extensions, blAST identifies the architectural intent of a file. We translate this heuristic telemetry into 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 or the CLI completes.

The Biaxial Security Lens

Traditional security scanners rely on rigid, outdated signatures or easily confused LLMs. blAST acts as an autonomous AppSec firewall, hunting for the structural heuristics of a threat. By analyzing the density of I/O hits, execution triggers, and security bypasses—and comparing them against local language physics—blAST is perfectly engineered to detect logic bombs, obscured payloads, and injection surfaces.



🌌 Powered by the blAST Engine

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

Morty Proxy This is a proxified and sanitized view of the page, visit original site.