secret-tools/kaos-tools: Kaos Tools — a Python workspace for file analysis, structured data and authorised diagnostics.

Inspect. Understand. Keep the result.

A searchable workspace for file analysis, structured data and authorised diagnostics.

Preview · Get started · Use cases · Catalogue · Docs

Français · English · Español · Deutsch · 中文 · العربية

Useful tools. One place to find them.

Check a file’s metadata, untangle JSON, find duplicate files or inspect a domain you manage. Search for the option with Ctrl + K, provide your input and read the result.

Successful standard-tool results are saved automatically to Output//, with unique filenames. Your next step can start where the last one finished.

See the actual interface

Actual standard-catalogue capture from version 1.0, using the Crimson theme. Some technical labels remain in their original language.

See a structured JSON workflow

Start in three steps

You need Windows and Python 3.12 or newer. An internet connection is required to install dependencies and use online lookups.

1. Download the repository with Code → Download ZIP, then extract it completely.
2. Run setup.bat to create the environment and install dependencies.
3. Run start.bat to open Kaos Tools.

Keep the launchers beside the Kaos folder. If setup reports an error, resolve it before launching. For help getting started, contact the team on Discord.

Three ways to put Kaos to work

01 · Understand a file

Put a file in Input/, or use the picker where available. Open EXIF Forensic, PDF Inspector or ZIP Inspector to examine it. Use File SHA256 for a fingerprint, or Duplicate File Finder to compare a folder.

You get: metadata, file details or a comparison report you can keep. A matching hash identifies matching content; it does not prove a file is safe.

02 · Make data readable

Open JSON Format, paste your JSON or select a file, then run the tool. Use JSON Diff for comparisons, JSON Pointer to query a value, or the CSV converters to move between formats.

For example, this compact input:

{"project":"Kaos Tools","tools":["JSON Format","File SHA256"]}

becomes readable JSON:

{
  "project": "Kaos Tools",
  "tools": [
    "JSON Format",
    "File SHA256"
  ]
}

You get: structured data you can read, copy and reuse. This is an illustrative formatting example; the actual application capture is above.

03 · Check a domain you manage

Start with DNS Records, then SSL Certificate Info and HTTP Headers. Use Email Domain Audit to review SPF/DMARC configuration or Domain RDAP for registration information.

You get: the records, certificate details and response information needed to investigate configuration. Online results depend on external services and their availability.

Make it your workspace

| Action | Control | | :--- | :--- | | Find a tool | Ctrl + K | | Choose a theme | F2 | | Toggle animations | F6 | | Quit | Ctrl + Q |

Six languages: Français · English · Español · Deutsch · 中文 · العربية. Ten themes: Crimson · Glacier · Orchid · Ivory · Emerald · Amber · Ocean · Rose · Mono · Rainbow.

For direct launch commands, run python Kaos/main.py --help. Use --list-tools to list identifiers and --tool to open a tool directly.

The toolkit

Scope and service limits

Online lookups send the supplied query to external providers. Access, quotas and permitted uses depend on the provider. The current ip-api integration uses its free endpoint; review its conditions before commercial use. The Reddit profile lookup still needs a documented authentication flow.

The 78 standard tools focus on local file/data analysis, public-information queries and authorised diagnostics. Network tools must be used within a scope you own or have permission to test. Respect privacy and the conditions of the services you query.

Imported third-party scripts are outside the standard catalogue. Review their source and origin before running them; they execute with your Windows user’s permissions.

A clean workspace

Kaos-Tools/
├── start.bat       Launch the toolkit
├── setup.bat       Install dependencies
├── Input/          Files to analyse and local packs
├── Output/         Exported results and screenshots
└── Kaos/           Application code and dependency declarations

Relative file paths are resolved from Input. Local preferences are stored in %LOCALAPPDATA%/KaosTools/settings.json. Keep personal inputs, exports and local settings out of the repository.

Stay connected

Version 1.0

This build improves Input/ path handling, uniquely named exports and file pickers for comparison and email-header analysis. JSON, CSV, XML and UTF-8 exports retain their formats; QR generation also saves PNG files.

Read the changelog →

The Kaos identity