Humanize CLI

Command-line tools for detecting and auto-fixing AI writing patterns.

Scripts

analyze.py — Detect AI Patterns

Scans text and reports AI vocabulary, puffery, chatbot artifacts, and auto-replaceable phrases.

# Analyze a file
python scripts/analyze.py input.txt
Analyze from stdin
echo "This serves as a testament to our commitment" | python scripts/analyze.py
JSON output for programmatic use

python scripts/analyze.py input.txt --json

Output example:

==================================================
AI PATTERN ANALYSIS - 5 issues found
==================================================
AI VOCABULARY:
• testament: 1x
• crucial: 2x
AUTO-REPLACEABLE:
• "serves as" → "is": 1x
• "in order to" → "to": 1x

humanize.py — Auto-Replace Patterns

Performs automatic replacements for common AI-isms.

# Humanize and print to stdout
python scripts/humanize.py input.txt
Write to output file
python scripts/humanize.py input.txt -o output.txt
Include em dash replacement
python scripts/humanize.py input.txt --fix-dashes
Quiet mode (no change log)

python scripts/humanize.py input.txt -q

What it fixes automatically:

Filler phrases: "in order to" → "to", "due to the fact that" → "because"
Copula avoidance: "serves as" → "is", "boasts" → "has"
Sentence starters: removes "Additionally,", "Furthermore,", "Moreover,"
Curly quotes → straight quotes
Chatbot artifacts: removes "I hope this helps", "Let me know if", etc.

Workflow

Analyze first to see what needs fixing:

python scripts/analyze.py document.txt

Auto-fix safe replacements:

python scripts/humanize.py document.txt -o document_clean.txt

Manual review for AI vocabulary and puffery flagged by analyze (these require human judgment)

Re-analyze to confirm improvements:

python scripts/analyze.py document_clean.txt

Customizing Patterns

Edit

scripts/patterns.json

to add/remove:

```
ai_words
```
— vocabulary that flags but doesn't auto-replace
```
puffery
```
— promotional language to flag
```
replacements
```
— phrase → replacement mappings (empty string = delete)
```
chatbot_artifacts
```
— phrases to auto-remove
```
hedging_phrases
```
— excessive hedging to flag

Batch Processing

Process multiple files:

# Analyze all markdown files
for f in *.md; do
  echo "=== $f ===" 
  python scripts/analyze.py "$f"
done
Humanize all txt files in place
for f in *.txt; do
python scripts/humanize.py "$f" -o "$f.tmp" && mv "$f.tmp" "$f"
done

Humanize AI

AI Skill Market Insights

Be Part of the 2,318+ Developer Community

Humanize CLI

Scripts

analyze.py — Detect AI Patterns

Analyze from stdin

JSON output for programmatic use

humanize.py — Auto-Replace Patterns

Write to output file

Include em dash replacement

Quiet mode (no change log)

Workflow

Customizing Patterns

Batch Processing

Humanize all txt files in place

Quick Start

Manual Installation

TEAR & SHARE

Tags

document-release

中文去AI味

Copy Editing

Essence Distiller

文件总结 File Summary & Analysis

Channels

Learn

Compare

Company