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

1. Analyze first to see what needs fixing:

   python scripts/analyze.py document.txt
   

2. Auto-fix safe replacements:

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

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

4. 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

---