humanize-ai

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

```bash
# 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.

```bash
# 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:
   ```bash
   python scripts/analyze.py document.txt
   ```

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

---

## Customizin...