explaingit

void-ghost000/salt-map-lite

Analysis updated 2026-05-18

1PythonAudience · dataComplexity · 2/5LicenseSetup · easy

TLDR

A local Python tool that scans CSV files for hidden data inconsistencies like duplicate keys or bad formatting before you use the data elsewhere.

Mindmap

mindmap
  root((repo))
    What it does
      Finds CSV inconsistencies
      Groups root causes
    Tech stack
      Python
      PowerShell scripts
    Checks
      Duplicate keys
      Missing values
      Numeric outliers
    Reports
      Markdown for humans
      JSON for pipelines
    Audience
      Data analysts
      Pipeline builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan a CSV file for hidden formatting inconsistencies like leading zeros or trailing spaces before running a lookup or join.

USE CASE 2

Generate a human readable Markdown report and a machine readable JSON report of data quality issues in a spreadsheet.

USE CASE 3

Check a dataset for missing values, duplicate keys, and numeric outliers before feeding it into an AI ingestion pipeline.

What is it built with?

PythonPowerShell

How does it compare?

void-ghost000/salt-map-lite0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedatadeveloperresearcher

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Currently an early alpha release and only supports CSV files, not Excel XLSX workbooks.

In plain English

SALT-MAP Lite is a Python tool that checks CSV spreadsheet files for hidden inconsistencies before you use that data for lookups, joins, reports, or feeding it to an AI tool. Many spreadsheet problems are not loud errors that jump out at you: things like the number 123 stored as 00123 in one row and as 123 in another, extra trailing spaces on an ID like EMP-001, numbers accidentally stored as text, duplicate keys that only differ by formatting, missing values, or Excel error codes like N/A. A person skimming the file may not notice these, but automated pipelines and AI systems that read the data often break or produce wrong results because of them. The tool scans a CSV file, groups the individual problems it finds into root cause trees so related issues are shown together instead of as a flat list, and generates two kinds of reports: a Markdown file meant for a person to read, with summaries and a collapsible tree of findings, and a JSON file meant for machines, AI tools, or data pipelines to consume directly. It runs entirely on your own computer, so your CSV file is never uploaded anywhere. The project includes ready made scripts for Windows PowerShell that let you try it immediately on sample data or point it at your own file, plus manual Python commands for other setups. The tool also includes an optional integrity gate with three modes, off, warn, and enforce, that checks whether its own generated reports are internally consistent using a hash chain. The README is explicit that this checks the report generation process itself, not the correctness of your original data or the true cause of how it became inconsistent in the first place. The project is currently an early alpha version, 0.2.0-alpha.1, and does not yet handle Excel XLSX files directly, only CSV. It is licensed under Apache-2.0 and is described as a smaller offshoot of a larger, separate project called SALT or HSRAG-SAIT.

Copy-paste prompts

Prompt 1
Walk me through running SALT-MAP Lite on a sample CSV using the PowerShell demo script.
Prompt 2
Explain what the integrity gate's warn and enforce modes actually check in SALT-MAP Lite.
Prompt 3
Show me how to point SALT-MAP Lite at my own CSV file and read the resulting Markdown report.
Prompt 4
Describe the difference between SALT-MAP Lite's root-cause tree report and its flat findings report.

Frequently asked questions

What is salt-map-lite?

A local Python tool that scans CSV files for hidden data inconsistencies like duplicate keys or bad formatting before you use the data elsewhere.

What language is salt-map-lite written in?

Mainly Python. The stack also includes Python, PowerShell.

How hard is salt-map-lite to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is salt-map-lite for?

Mainly data.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.