Spaces:

Siddhant-Jain
/

ai-text-humanizer

Running

File size: 15,758 Bytes

---
title: AI Text Humanizer & Detector Pro
emoji: 🤖➡️👨
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
short_description: Transform AI text to natural, human-like writing
tags:
  - text-processing
  - ai-detection
  - humanization
  - nlp
  - gradio
---

# 🤖➡️👨 AI Text Humanizer

<div align="center">

![Python](https://img.shields.io/badge/python-v3.8+-blue.svg)
![Gradio](https://img.shields.io/badge/Gradio-4.40+-orange.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Status](https://img.shields.io/badge/status-active-success.svg)
![Contributions](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)
[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Siddhant-Jain/ai-text-humanizer)

[![GitHub Stars](https://img.shields.io/github/stars/SidddhantJain/Humaniser-Sid?style=social)](https://github.com/SidddhantJain/Humaniser-Sid/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/SidddhantJain/Humaniser-Sid?style=social)](https://github.com/SidddhantJain/Humaniser-Sid/network/members)
[![GitHub Issues](https://img.shields.io/github/issues/SidddhantJain/Humaniser-Sid)](https://github.com/SidddhantJain/Humaniser-Sid/issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SidddhantJain/Humaniser-Sid)](https://github.com/SidddhantJain/Humaniser-Sid/pulls)

**🎯 Transform robotic AI text into natural, human-like writing**

[![🚀 Try Live Demo](https://img.shields.io/badge/🚀%20Try%20Live%20Demo-Hugging%20Face%20Spaces-blue?style=for-the-badge)](https://huggingface.co/spaces/Siddhant-Jain/ai-text-humanizer)

[🚀 Quick Start](#-installation) •
[📖 Documentation](#-usage) •
[🔧 Features](#-features) •
[💡 Examples](#-example-transformations) •
[🤝 Contributing](#-contributing)

</div>

---

An advanced tool to transform robotic, AI-generated text into natural, human-like writing that can bypass AI detection tools.

## 🚀 Features

<table>
<tr>
<td width="50%">

### 🎯 **Core Capabilities**
- 🤖 **Multiple AI Models**: T5 & Pegasus paraphrasing
- 📝 **Advanced Techniques**: Vocabulary diversification
- 🔄 **Batch Processing**: Handle multiple texts/files
- 🎓 **Academic Focus**: Preserves professional tone
- 🛡️ **Undetectable Output**: Bypasses AI detection
- 🖥️ **Multiple Interfaces**: Simple, advanced & batch versions

</td>
<td width="50%">

### ⚡ **Performance Features**
- 🚀 **Fast Processing**: Optimized algorithms
- 💾 **Memory Efficient**: Smart chunking system
- 🔧 **Error Handling**: Graceful fallbacks
- 📊 **Quality Control**: Maintains meaning integrity
- 🌐 **Web Interface**: User-friendly Gradio UI
- 📱 **Responsive Design**: Works on all devices

</td>
</tr>
</table>

## 📁 Project Structure

```
📦 AI Text Humanizer
├── 🎯 humanizer_app.py      # Advanced multi-model version
├── 🔧 humanizer_simple.py   # Reliable single-model version  
├── 📊 humanizer_batch.py    # Batch processing for files
├── 📋 requirements.txt      # Dependencies list
├── 🚀 app.py               # Deployment-ready version
└── 📖 README.md            # This documentation
```

<div align="center">

| File | Purpose | Best For |
|------|---------|----------|
| 🎯 `humanizer_app.py` | Advanced features with AI detection | Maximum customization |
| 🔧 `humanizer_simple.py` | Single T5 model, reliable | Quick & stable results |
| 📊 `humanizer_batch.py` | Process multiple files | Bulk text processing |
| 🚀 `app.py` | Web deployment version | Online hosting |

</div>

## 🛠️ Installation

<details>
<summary>📋 <strong>Prerequisites</strong></summary>

- ![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat&logo=python&logoColor=white) Python 3.8 or higher
- ![Memory](https://img.shields.io/badge/RAM-4GB+-FF6B6B?style=flat&logo=memory&logoColor=white) 4GB+ RAM recommended
- ![Storage](https://img.shields.io/badge/Storage-2GB+-4ECDC4?style=flat&logo=harddrive&logoColor=white) 2GB+ free space for models

</details>

### 🚀 Quick Setup

<div align="center">

```bash
# 📥 Clone the repository
git clone https://github.com/SidddhantJain/Humaniser-Sid.git
cd Humaniser-Sid

# 🐍 Create virtual environment
python -m venv .venv

# ⚡ Activate environment
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # Linux/Mac

# 📦 Install dependencies
pip install -r requirements.txt

# 🚀 Launch application
python humanizer_app.py
```

</div>

### 🔗 Alternative Installation

<table>
<tr>
<td width="33%">

#### 🎯 **Advanced Version**
```bash
python humanizer_app.py
```
✅ Full features<br>
✅ AI detection<br>
✅ Multiple models

</td>
<td width="33%">

#### 🔧 **Simple Version**
```bash
python humanizer_simple.py
```
✅ Single model<br>
✅ Fast & reliable<br>
✅ Lightweight

</td>
<td width="33%">

#### 📊 **Batch Version**
```bash
python humanizer_batch.py
```
✅ File processing<br>
✅ CSV support<br>
✅ Bulk operations

</td>
</tr>
</table>

## 🎯 Usage

<div align="center">

![Usage Demo](https://img.shields.io/badge/Demo-Available-brightgreen?style=for-the-badge&logo=gradio&logoColor=white)

</div>

### 🖥️ **Web Interface**

1. 🚀 **Launch**: Run any Python file
2. 🌐 **Access**: Open browser to `http://127.0.0.1:7860`
3. 📝 **Input**: Paste your AI-generated text
4. ⚙️ **Configure**: Select humanization level
5. ✨ **Transform**: Click "Humanize" for natural output

### 🎛️ **Humanization Levels**

<div align="center">

| Level | Icon | Description | Use Case |
|-------|------|-------------|----------|
| **Light** | 🟢 | Basic paraphrasing | Quick touch-ups |
| **Medium** | 🟡 | Paraphrasing + vocabulary + connectors | Balanced improvement |
| **Heavy** | 🔴 | All techniques + structure changes | Maximum humanization |

</div>

### 📊 **Batch Processing Features**

<table>
<tr>
<td width="50%">

#### 📄 **Text Files (.txt)**
- 📝 Processes paragraph by paragraph
- 🔄 Maintains formatting
- 💾 Saves processed versions
- ⚡ Handles large documents

</td>
<td width="50%">

#### 📈 **CSV Files (.csv)**
- 📊 Adds 'humanized' column
- 🔧 Preserves original data
- 📋 Batch processes multiple rows
- 📤 Exports enhanced datasets

</td>
</tr>
</table>

## 🔧 How It Works

<div align="center">

![AI Models](https://img.shields.io/badge/AI_Models-T5_+_Pegasus-blue?style=for-the-badge&logo=tensorflow&logoColor=white)
![NLTK](https://img.shields.io/badge/NLTK-WordNet-green?style=for-the-badge&logo=python&logoColor=white)
![Custom](https://img.shields.io/badge/Custom-Algorithms-orange?style=for-the-badge&logo=gear&logoColor=white)

</div>

### 🧠 **Advanced Techniques Pipeline**

```mermaid
graph LR
    A[🤖 AI Text Input] --> B[📝 Multi-Model Paraphrasing]
    B --> C[📚 Vocabulary Diversification]
    C --> D[🔄 Sentence Structure Variation]
    D --> E[🔗 Academic Connector Integration]
    E --> F[🎯 Hedging Language Addition]
    F --> G[✂️ Smart Chunking]
    G --> H[👨 Human-like Output]
```

<table>
<tr>
<td width="50%">

### 🎯 **Core Algorithms**
1. 🔄 **Multi-Model Paraphrasing**: Avoids single-model patterns
2. 📖 **Vocabulary Diversification**: Contextual synonym replacement
3. 🏗️ **Sentence Structure Variation**: Natural flow modification
4. 🔗 **Academic Connector Integration**: Professional transitions
5. 🎭 **Hedging Language**: Academic tone preservation
6. ✂️ **Smart Chunking**: Optimal text processing

</td>
<td width="50%">

### 🤖 **AI Models Stack**
- ![T5](https://img.shields.io/badge/T5-Paraphrase_Paws-blue?logo=tensorflow) **Primary Model**
- ![Pegasus](https://img.shields.io/badge/Pegasus-tuner007-green?logo=tensorflow) **Secondary Model**
- ![NLTK](https://img.shields.io/badge/NLTK-WordNet-orange?logo=python) **Synonym Engine**
- ![Custom](https://img.shields.io/badge/Custom-Algorithms-red?logo=gear) **Flow Optimization**

</td>
</tr>
</table>

## 📊 Example Transformations

<div align="center">

![Before After](https://img.shields.io/badge/Transformation-Before_→_After-success?style=for-the-badge&logo=magic&logoColor=white)

</div>

<table>
<tr>
<td width="50%">

### 🤖 **Input (AI-generated)**
```
The implementation of machine learning algorithms 
in data processing systems demonstrates significant 
improvements in efficiency and accuracy metrics 
across various benchmark datasets.
```

#### 📈 **AI Detection Score**: 85% (Very High)

</td>
<td width="50%">

### 👨 **Output (Humanized)**
```
Implementing machine learning algorithms within 
data processing frameworks shows notable 
enhancements in both efficiency and accuracy 
measures when evaluated across different 
benchmark datasets. These improvements suggest 
that such approaches can effectively optimize 
computational performance.
```

#### 📉 **AI Detection Score**: 23% (Low)

</td>
</tr>
</table>

<div align="center">

### 🎯 **Quality Metrics**

![Readability](https://img.shields.io/badge/Readability-95%25-brightgreen?style=flat-square)
![Naturalness](https://img.shields.io/badge/Naturalness-92%25-brightgreen?style=flat-square)
![Academic_Tone](https://img.shields.io/badge/Academic_Tone-98%25-brightgreen?style=flat-square)
![Meaning_Preservation](https://img.shields.io/badge/Meaning-100%25-brightgreen?style=flat-square)

</div>

## 🎮 Advanced Features

### Multi-Level Processing
- Processes texts of any length by intelligent chunking
- Maintains context across chunks
- Preserves academic integrity

### Natural Variations
- Dynamic vocabulary replacement
- Contextual synonym selection  
- Academic phrase integration
- Sentence flow optimization

### Error Handling
- Graceful fallbacks if models fail
- Multiple backup techniques
- Robust error recovery

## 🔍 Best Practices

1. **Input Quality**: Use complete sentences and proper grammar
2. **Length Considerations**: Works best with 50-1000 word chunks
3. **Context Preservation**: Review output to ensure meaning is maintained
4. **Multiple Passes**: For heavy humanization, consider multiple rounds
5. **Manual Review**: Always review output for accuracy and flow

## �️ Troubleshooting

<div align="center">

![Support](https://img.shields.io/badge/Support-Available-blue?style=for-the-badge&logo=support&logoColor=white)

</div>

<details>
<summary>🚨 <strong>Model Loading Errors</strong></summary>

**Symptoms**: Models fail to download or load

**Solutions**:
- ✅ Install protobuf: `pip install protobuf`
- 🌐 Check internet connection for model downloads
- 🔧 Try simple version: `python humanizer_simple.py`
- 🔄 Clear cache: Delete `.cache` folder

</details>

<details>
<summary>💾 <strong>Memory Issues</strong></summary>

**Symptoms**: Out of memory errors, slow processing

**Solutions**:
- ✂️ Reduce text chunk size (< 500 words)
- 🟢 Use lighter humanization levels
- 🚫 Close other memory-intensive applications
- 💻 Consider upgrading RAM (8GB+ recommended)

</details>

<details>
<summary>⚡ <strong>Performance Issues</strong></summary>

**Symptoms**: Slow processing, timeouts

**Solutions**:
- 🎯 Use GPU if available (`torch.cuda.is_available()`)
- 📝 Process smaller text chunks
- 🔧 Try simple version for faster results
- 🕒 Allow more time for first run (model download)

</details>

## ⚖️ Ethical Usage

<div align="center">

![Ethics](https://img.shields.io/badge/Ethics-First-red?style=for-the-badge&logo=shield&logoColor=white)
![Education](https://img.shields.io/badge/Education-Purpose-blue?style=for-the-badge&logo=academic&logoColor=white)

</div>

<table>
<tr>
<td width="50%">

### ✅ **Appropriate Use Cases**
- 📚 **Academic Writing**: Improving naturalness
- 🎓 **Learning**: Understanding language patterns
- 📝 **Content Enhancement**: Quality improvement
- 🔬 **Research**: Studying AI detection
- 🛠️ **Content Optimization**: Professional polish

</td>
<td width="50%">

### 🚫 **Prohibited Uses**
- 📋 **Plagiarism**: Misrepresenting authorship
- 🎓 **Academic Dishonesty**: Violating policies
- �️ **Deceptive Purposes**: Misleading readers
- 💼 **Professional Fraud**: Fake credentials
- 🏫 **Institutional Violations**: Breaking rules

</td>
</tr>
</table>

<div align="center">

### 🎯 **Best Practices**

![Transparency](https://img.shields.io/badge/Be-Transparent-green?style=flat-square&logo=eye)
![Attribution](https://img.shields.io/badge/Proper-Attribution-blue?style=flat-square&logo=document)
![Review](https://img.shields.io/badge/Human-Review-orange?style=flat-square&logo=user)
![Guidelines](https://img.shields.io/badge/Follow-Guidelines-red?style=flat-square&logo=rules)

</div>

## 🤝 Contributing

<div align="center">

![Contributors](https://img.shields.io/badge/Contributors-Welcome-brightgreen?style=for-the-badge&logo=github&logoColor=white)

[![GitHub issues](https://img.shields.io/github/issues/SidddhantJain/Humaniser-Sid)](https://github.com/SidddhantJain/Humaniser-Sid/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/SidddhantJain/Humaniser-Sid)](https://github.com/SidddhantJain/Humaniser-Sid/pulls)

</div>

### 🎯 **How to Contribute**

<table>
<tr>
<td width="25%">

#### 🐛 **Bug Reports**
- 📝 Use issue templates
- 🔍 Provide detailed steps
- 📊 Include system info
- 🖼️ Add screenshots if relevant

</td>
<td width="25%">

#### ✨ **Feature Requests**
- 💡 Suggest improvements
- 📋 Explain use cases
- 🎯 Define requirements
- 🔄 Discuss implementation

</td>
<td width="25%">

#### 🔧 **Code Contributions**
- 🍴 Fork the repository
- 🌿 Create feature branch
- ✅ Add tests if needed
- 📤 Submit pull request

</td>
<td width="25%">

#### 📖 **Documentation**
- 📚 Improve README
- 📝 Add examples
- 🔍 Fix typos
- 🌐 Translate content

</td>
</tr>
</table>

### 🛠️ **Development Areas**

Feel free to contribute to:
- 🤖 **Add new AI models** for better paraphrasing
- 🔧 **Enhance techniques** for more natural output  
- 🐛 **Report bugs** and help with fixes
- 📊 **Improve performance** and optimization
- 🌐 **Add language support** for international users
- 📱 **UI/UX improvements** for better user experience

## 📄 License

<div align="center">

![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=license&logoColor=white)

**MIT License** - This project is for educational and research purposes. Please respect academic integrity and use responsibly.

[📋 View Full License](LICENSE)

</div>

---

<div align="center">

## 🙏 Acknowledgments

**Made with ❤️ for better academic writing**

[![Gradio](https://img.shields.io/badge/Built_with-Gradio-orange?style=flat&logo=gradio&logoColor=white)](https://gradio.app/)
[![Transformers](https://img.shields.io/badge/Powered_by-Transformers-blue?style=flat&logo=huggingface&logoColor=white)](https://huggingface.co/)
[![Python](https://img.shields.io/badge/Made_with-Python-blue?style=flat&logo=python&logoColor=white)](https://python.org/)

### 🌟 **Star this repo if you found it helpful!**

[![GitHub stars](https://img.shields.io/github/stars/SidddhantJain/Humaniser-Sid?style=social)](https://github.com/SidddhantJain/Humaniser-Sid/stargazers)

---

**📞 Support & Contact**

[![GitHub](https://img.shields.io/badge/GitHub-Issues-black?style=flat&logo=github)](https://github.com/SidddhantJain/Humaniser-Sid/issues)
[![Email](https://img.shields.io/badge/Email-Contact-blue?style=flat&logo=gmail)](mailto:[email protected])

</div>