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: bash python scripts/analyze.py document.txt
Auto-fix safe replacements: bash 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: bash 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