Spaces:
Running
Running
A newer version of the Gradio SDK is available:
5.44.1
metadata
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
๐ฏ Transform robotic AI text into natural, human-like writing
๐ Quick Start โข ๐ Documentation โข ๐ง Features โข ๐ก Examples โข ๐ค Contributing
An advanced tool to transform robotic, AI-generated text into natural, human-like writing that can bypass AI detection tools.
๐ Features
๐ 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
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 |
๐ ๏ธ Installation
๐ Quick Setup
# ๐ฅ 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
๐ Alternative Installation
๐ฏ Usage
๐ฅ๏ธ Web Interface
- ๐ Launch: Run any Python file
- ๐ Access: Open browser to
http://127.0.0.1:7860
- ๐ Input: Paste your AI-generated text
- โ๏ธ Configure: Select humanization level
- โจ Transform: Click "Humanize" for natural output
๐๏ธ Humanization Levels
Level | Icon | Description | Use Case |
---|---|---|---|
Light | ๐ข | Basic paraphrasing | Quick touch-ups |
Medium | ๐ก | Paraphrasing + vocabulary + connectors | Balanced improvement |
Heavy | ๐ด | All techniques + structure changes | Maximum humanization |
๐ Batch Processing Features
๐ง How It Works
๐ง Advanced Techniques Pipeline
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]
๐ Example Transformations
๐ฎ 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
- Input Quality: Use complete sentences and proper grammar
- Length Considerations: Works best with 50-1000 word chunks
- Context Preservation: Review output to ensure meaning is maintained
- Multiple Passes: For heavy humanization, consider multiple rounds
- Manual Review: Always review output for accuracy and flow
๏ฟฝ๏ธ Troubleshooting
๐จ Model Loading Errors
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
๐พ Memory Issues
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)
โก Performance Issues
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)
โ๏ธ Ethical Usage
๐ค Contributing
๐ฏ How to Contribute
๐ ๏ธ 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
MIT License - This project is for educational and research purposes. Please respect academic integrity and use responsibly.