Skip to content

squid-protocol/gitgalaxy

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

704 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GitGalaxy

Docs Β· Visualizer

PyPI version Python 3.09+ License: PolyForm Noncommercial Velocity Analysis Architecture

Zero Dependencies Airgap Ready

1 scan Β· 97 structural signals Β· 50+ languages Β· 0 need for compilation
19 risk exposure scores Β· 6 final reports Β· 0 dependencies Β· pip install gitgalaxy

Gitgalaxy can assess full repos, comprised of mixes of 50+ different languages and map out the architecture, provide risk exposures and actionable fixes to lower those exposures. The graph below is a workflow from one gitgalaxy scan from on our golden test repo, which contains sample code files from the Apollo-11 1969 flight software through the modern tech stacks. Benchmark
GitGalaxy Architecture Pipeline

**Whole-Repository Intelligence with a Unique Security Layer **

Gitgalaxy is a tool to determistically audit code, fast enough for the CI pipeline. Most code intelligence engines use an AST, like tree-sitter, which is offers an overly granular view of a repos (like asking to understand a house and getting a list of every brick and glass pane) and it limits the languages and files that can be scanned. Modern repos are poly-lingual. Many repos have old code without a good AST. To bypass this, Gitgalaxy uses a custom regex/lexical structural-analysis engine with a statistics layer on top β€” it builds a feature vector per file (from ~97 regex "signal" categories - that mark the boundaries of functions, control flow, I/O, state mutation, and dozens of other structural and security-relevant behaviors) and per repo (dependency graph via import resolution + PageRank/centrality), then transforms those raw counts into normalized 0–100 risk scores via sigmoid functions, and exports the result to six formats.

Gitgalaxy trades AST-level precision for orders-of-magnitude speed and universal language coverage, in the same spirit that BLAST traded Smith-Waterman's exhaustive alignment for heuristic speed in genomics. Output includes SARIF, CycloneDX SBOM, a queryable SQLite knowledge graph, an LLM-optimized architecture brief, and 3D visualization data from a single scan pass that takes seconds.

The result is a deterministic knowledge graph of the repository, built without ever requiring the code to compile. It calculates the ratio of test code to core logic, maps each file's downstream "blast radius" through the dependency graph, and surfaces project-structure signal that line-by-line linters miss entirely. Per-file signal extraction runs in time linear to codebase size; repository-level graph metrics (centrality, community detection) use standard network-analysis algorithms with explicit sampling bounds on very large graphs.

Our unique engine allows for the unique ways to scan for several CWEs families without the need for CVE lists, which is a unique edge for our code intelligence engine.

Scanning Apollo-11 with the blAST Engine

GitGalaxy CLI Scan

What GitGalaxy Finds β€” and What It Doesn't Claim

GitGalaxy produces two different kinds of output, and they should be read differently.

Risk Exposure scores are a 0–100, density-normalized signal across 19 categories (secrets, injection surface, memory corruption, and more), rolled up from function to file to folder to repository. A high score means this deserves attention first β€” it is a prioritization signal, not a verdict. Two files can carry the same score for completely different reasons: a real problem, or a legitimate pattern that looks identical on the surface. Encrypted malware and a well-tested cryptography routine both produce high entropy. GitGalaxy can't tell you which one it found β€” only that something worth a second look is there.

Findings are individual, line-level flags: a specific Structural Signature that crossed a risk threshold. These are evidence to review, not confirmed vulnerabilities. GitGalaxy never executes code, traces runtime dataflow, or verifies exploitability β€” it tells you a pattern exists in the text, at this exact line, and hands you the context to judge it yourself.

This is intentional, not a limitation we're hiding. GitGalaxy is built to err toward recall over precision: flag more, and let a human or a deeper tool narrow the list, rather than risk staying silent on something real. False positives are the expected cost of that trade-off, the same way they are for every static analyzer that doesn't execute the code it reads.

That also means GitGalaxy is strongest against a specific class of problem β€” negligence, not adversarial evasion. A hardcoded key someone forgot to remove, an insecure registry, an obviously dangerous eval() call β€” nobody on the other end of those is trying to hide from a scanner. A specifically motivated attacker who knows how static, signature-based detection works can evade individual signals like entropy thresholds without much effort. Treat GitGalaxy as the fast first pass across a codebase too large to read by hand β€” not the last word on whether something is safe.

Weakness Classes, Not Just Known CVEs

Most dependency scanners work from a lookup table: they know a vulnerability exists because someone found it, filed it, and it now has a CVE number in a feed. That's useful, but it's necessarily reactive β€” a scanner built this way is blind to anything that hasn't been discovered and disclosed yet, including straightforward variants of known-bad patterns that just look slightly different from the filed instance.

GitGalaxy takes a different approach: instead of matching known instances, it matches weakness classes. Its findings are tagged by CWE (Common Weakness Enumeration) β€” hardcoded credentials, dynamic code execution, unsafe deserialization β€” not by CVE ID. A structural signature for "dynamic execution of tainted input" catches that pattern wherever it appears, with whatever variable names, in whatever specific arrangement β€” not just the one instance someone already filed a report about.

The same philosophy extends to the SBOM layer. Rather than asking "does this package version appear in a vulnerability database," GitGalaxy's zero-trust physical audit asks "does this package's actual content on disk structurally match what a legitimate version should look like" β€” entropy, structural fingerprint, behavioral anomaly flags. That's how a tampered dependency gets caught on day one, before anyone has discovered or disclosed anything, because there's no CVE to wait for.

This is a complement to CVE-feed tools (Snyk, Dependabot, OSV-Scanner), not a replacement for them β€” those tools are the right answer for "is this exact known bug present." GitGalaxy is the right answer for the wider net: weakness classes and physical anomalies that don't require anyone to have found and filed the specific instance first.

Real-World Adoption

Tracking the total, deduplicated volume of fetches across PyPI, GitHub, and GitLab against our baseline control repositories.

GitGalaxy Cumulative Downloads

Measured without mirrors. The GitHub/PyPI breakdown lines begin partway through the window because per-source tracking was added after total-fetch tracking; the total line before that point is aggregate across all sources.

Benchmarks

Data Privacy & On-Premise Deployment

  • 100% air-gapped execution
  • On-premise deployment
  • Zero-trust processing model

Installation & Usage

CI/CD Integration

Drop the template for your platform straight into your pipeline β€” each one runs a GitGalaxy scan and can fail the build on risk-threshold or malware-signature breaches.

Platform Template
GitHub Actions gitgalaxy-pipeline.yml β€” see the full integration guide
GitLab CI scan.yml
Bitbucket Pipelines bitbucket-pipelines.yml + bitbucket_insights.py (posts findings as Bitbucket Code Insights annotations)
Azure Pipelines azure-pipelines.yml
Anything else (Jenkins, CircleCI, etc.) scan.yml β€” generic, shell-invocable template

Enterprise Codebase Tools & Use Cases

GitGalaxy operates on a Decoupled Architecture. While the core engine provides the overarching structural mechanics and topological mapping, our specialized Decoupled Execution Controllers leverage that deterministic graph to execute enterprise-grade operations.

A deterministic, high-fidelity translation pipeline. It converts legacy COBOL into fully compiling, modern Spring Boot architectures, mapping memory exactly and scaffolding JPA entities, REST controllers, and Maven builds before utilizing AI to translate isolated business logic.

An analytical suite for sanitizing mainframe monoliths. It safely neutralizes legacy lexical traps, extracts dead execution memory, maps topological DAG execution orders, and generates Zero-Trust JCL configurations for modern cloud deployments.

  • Proven Metric: The dead-code extraction engine removed over 6,700 lines of dead execution blocks and orphaned variables from the standard IBM CICS benchmark app in seconds.

Extreme-velocity pre-commit firewalls. Instead of trusting manifest files, it scans physical internals to block steganography, byte-level XOR decryption loops, homoglyph typosquatting, and exposed cryptographic vaults before they ever enter your CI/CD pipeline. Deploy directly via our GitHub Action.

A Zero-Trust Software Bill of Materials (SBOM) generator. It refuses to blindly trust package.json or requirements.txt files, instead locating the physical dependencies on disk, mathematically verifying their entropy and linguistic identity, and generating strict CycloneDX 1.4 JSON reports.

  • Proven Metric: Successfully mapped and mathematically verified the physical internals of 170 unique Go modules inside the local Kubernetes repository.

A deterministic mapping tool that hunts undocumented vulnerabilities. It uses structural regex to find active physical routing logic (Express, Spring Boot, FastAPI) and applies set theory against official OpenAPI/Swagger documentation to isolate critical Shadow APIs and outdated Ghost APIs.

Unindexed, tactical log analysis operating at 0.07 GB/sec. It streams massive database dumps to deterministically hunt and mask PII (Credit Cards, SSNs, AWS Keys) and uses static architecture maps to prove exact runtime execution frequencies with ASCII time-series histograms.

Specialized keyword sensors protecting both your application and your codebase. The AppSec Sensor detects weaponized LLM features (RCE funnels, exfiltration risks), while the Dev Agent Firewall evaluates token mass and blast radius to restrict autonomous coding agents from modifying dangerous or context-token-draining files. Helps identify which files need to be chunked to reduce context overload.

Local Browser-Based 3D Codebase Visualization

If you prefer visual analytics, we've built a topological dashboard where each file represents a node, sized and colored according to specific risk metrics.

Simply drag and drop your generated your_repo_GPU_galaxy.json file (or a .zip of your raw repository) directly into GitGalaxy.io. All rendering and scanning happens entirely in your browser's local memory.

πŸ”­ Watch GitGalaxy in Action

Mapping 3.2 Million Lines of C++ in 11 Seconds | OpenCV OpenCV Demo

GitGalaxy Topological Visualizer 3D graph rendering complex software repository structures and K-means clustering archetypes in the browser

Zero-Trust Data Security

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.
  • Privacy-by-Design: Even when using the web-based viewer, the data remains behind the user's firewall at all times.

βš–οΈ Licensing & Usage

Copyright (c) 2026 Joe Esquibel

GitGalaxy is distributed under the PolyForm Noncommercial License 1.0.0.

πŸŽ“ Community Free Tier (Academic, Research, & Hobbyist)

We are deeply committed to the open-source and academic communities. If you are using GitGalaxy for personal projects, academic research, or non-commercial development, the engine is 100% free to use.

To suppress the commercial licensing delays in your terminal or personal CI/CD pipelines, simply set the following environment variable:

export GITGALAXY_LICENSE_KEY="COMMUNITY_FREE_TIER"

🏒 Commercial & Enterprise Use

Running GitGalaxy in corporate environments, proprietary codebases, or commercial CI/CD pipelines requires an enterprise license. Unlicensed corporate pipelines will experience intentional execution friction, and attempting to use the Community Free Tier key in a corporate environment will trigger explicit non-compliance warnings in your audit logs.

To acquire a zero-trust commercial key for your organization and ensure clean compliance logs, please contact: joe@gitgalaxy.io