Spaces:

Siddhant-Jain
/

ai-text-humanizer

Running

App Files Files Community

ai-text-humanizer / README.md

SidddhantJain

Add live demo links and dependency test file

bff7fa2 29 days ago

preview code

raw

history blame contribute delete

15.8 kB

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