Spaces:
Running
Running
| # 🤖➡️👨 AI Text Humanizer & Detector Pro | |
| <div align="center"> | |
|  | |
|  | |
|  | |
|  | |
| [](https://huggingface.co/spaces) | |
| [](https://railway.app) | |
| [](https://render.com) | |
| **🌐 Deploy your AI humanizer to the cloud with one click** | |
| [🚀 Quick Deploy](#-deployment-options) • | |
| [📖 Documentation](#-features) • | |
| [🔧 Setup Guide](#-installation) • | |
| [💡 Examples](#-usage-examples) • | |
| [🆘 Support](#-support) | |
| </div> | |
| --- | |
| A comprehensive web application for transforming AI-generated text into natural, human-like writing while providing advanced AI detection capabilities. | |
| ## ✨ Features | |
| <div align="center"> | |
|  | |
|  | |
|  | |
| </div> | |
| <table> | |
| <tr> | |
| <td width="33%"> | |
| ### 🎭 **Text Humanizer** | |
| - 🔄 **Advanced Vocabulary Enhancement** | |
| - 📝 **Sentence Flow Optimization** | |
| - 🏗️ **Structure Diversification** | |
| - 🎓 **Academic Tone Preservation** | |
| - ⚡ **Multi-level Processing** | |
|  | |
| </td> | |
| <td width="33%"> | |
| ### 🕵️ **AI Detector** | |
| - 🎯 **7-Point Analysis System** | |
| - 📊 **Detailed Scoring Breakdown** | |
| - 🔍 **Confidence Level Assessment** | |
| - 🤖 **Pattern Recognition Engine** | |
| - ⚡ **Real-time Analysis** | |
|  | |
| </td> | |
| <td width="33%"> | |
| ### 🔄 **Combined Processing** | |
| - 🚀 **One-Click Workflow** | |
| - 🔁 **Optimization Loop** | |
| - ✅ **Quality Validation** | |
| - 📊 **Performance Metrics** | |
| - 🎯 **Result Verification** | |
|  | |
| </td> | |
| </tr> | |
| </table> | |
| ## 🚀 Live Demo | |
| Visit the live application: [Hugging Face Spaces](https://huggingface.co/spaces/YOUR_USERNAME/ai-text-humanizer) | |
| ## 📦 Installation | |
| <div align="center"> | |
|  | |
| </div> | |
| ### 🔧 **Local Development Setup** | |
| <details> | |
| <summary>📋 <strong>System Requirements</strong></summary> | |
| | Component | Requirement | Recommended | | |
| |-----------|-------------|-------------| | |
| |  | 3.8+ | 3.9+ | | |
| |  | 4GB+ | 8GB+ | | |
| |  | 2GB+ | 5GB+ | | |
| |  | For models | Stable connection | | |
| </details> | |
| ### 🚀 **Quick Start** | |
| ```bash | |
| # 📥 1. Clone Repository | |
| git clone https://github.com/SidddhantJain/Humaniser-Sid.git | |
| cd Humaniser-Sid | |
| # 🐍 2. Setup Environment | |
| python -m venv .venv | |
| .venv\Scripts\activate # Windows | |
| source .venv/bin/activate # Linux/Mac | |
| # 📦 3. Install Dependencies | |
| pip install -r requirements.txt | |
| # 🚀 4. Launch Application | |
| python app.py | |
| ``` | |
| <div align="center"> | |
|  | |
| </div> | |
| ### 📋 **Dependencies** | |
| <table> | |
| <tr> | |
| <td width="50%"> | |
| #### 🎯 **Core Dependencies** | |
| ``` | |
| gradio==4.44.0 # Web interface | |
| transformers==4.35.0 # AI models | |
| torch==2.1.0 # Deep learning | |
| nltk==3.8.1 # Language processing | |
| ``` | |
| </td> | |
| <td width="50%"> | |
| #### 🔧 **Supporting Libraries** | |
| ``` | |
| textstat==0.7.3 # Text analysis | |
| numpy==1.24.3 # Numerical computing | |
| pandas==2.0.3 # Data manipulation | |
| protobuf # Model serialization | |
| ``` | |
| </td> | |
| </tr> | |
| </table> | |
| ## 🛠️ Technical Details | |
| ### Humanization Algorithms | |
| - **Vocabulary Diversification**: WordNet-based synonym replacement | |
| - **Structural Variation**: Sentence pattern modification | |
| - **Natural Flow Enhancement**: Academic connector and hedge phrase insertion | |
| - **Linguistic Pattern Breaking**: AI-specific phrase elimination | |
| ### AI Detection Metrics | |
| 1. **AI Phrase Detection**: Identifies common AI-generated expressions | |
| 2. **Vocabulary Repetition**: Analyzes overuse of academic terms | |
| 3. **Structure Patterns**: Detects repetitive sentence starters | |
| 4. **Transition Overuse**: Measures excessive formal connectors | |
| 5. **Formal Pattern Recognition**: Identifies robotic phrasing | |
| 6. **Sentence Consistency**: Analyzes unnatural uniformity | |
| 7. **Readability Assessment**: Evaluates writing naturalness | |
| ## 📈 Usage Examples | |
| ### Input (AI-Generated): | |
| ``` | |
| The implementation of artificial intelligence algorithms demonstrates significant improvements in computational efficiency and accuracy metrics across various benchmark datasets. | |
| ``` | |
| ### Output (Humanized): | |
| ``` | |
| AI algorithms show notable improvements in both computational efficiency and accuracy when tested across different benchmark datasets. These results indicate considerable advances in performance. | |
| ``` | |
| ## 🔧 Configuration | |
| ### Humanization Levels: | |
| - **Light**: Basic vocabulary substitution | |
| - **Medium**: Vocabulary + natural flow enhancement | |
| - **Heavy**: All techniques including structure modification | |
| ### AI Detection Thresholds: | |
| - **0-20%**: Likely human-written | |
| - **21-40%**: Possibly AI-generated | |
| - **41-60%**: Probably AI-generated | |
| - **61-80%**: Likely AI-generated | |
| - **81-100%**: Very likely AI-generated | |
| ## 🌐 Deployment Options | |
| <div align="center"> | |
|  | |
| </div> | |
| <table> | |
| <tr> | |
| <td width="33%"> | |
| ### 🤗 **Hugging Face Spaces** | |
| #### ⭐ RECOMMENDED - FREE | |
|  | |
| **✅ Benefits:** | |
| - 🆓 Completely FREE forever | |
| - ⚡ Auto-deployment from files | |
| - 🌍 Global CDN (fast worldwide) | |
| - 🔒 SSL certificate included | |
| - 🛠️ No coding required | |
| - 📱 Mobile-friendly interface | |
| **🚀 Deploy Steps:** | |
| 1. Go to [huggingface.co/spaces](https://huggingface.co/spaces) | |
| 2. Click "Create new Space" | |
| 3. Choose Gradio SDK | |
| 4. Upload `app.py` & `requirements.txt` | |
| 5. ✨ Auto-deploy in 2-3 minutes! | |
| </td> | |
| <td width="33%"> | |
| ### 🚂 **Railway** | |
| #### 💰 FREE TIER AVAILABLE | |
|  | |
| **✅ Benefits:** | |
| - 🎯 GitHub integration | |
| - 🔄 Auto-deploy on push | |
| - 💾 Persistent storage | |
| - 📊 Built-in monitoring | |
| - 🔧 Environment variables | |
| - 💳 Credit card not required | |
| **🚀 Deploy Steps:** | |
| 1. Push code to GitHub | |
| 2. Go to [railway.app](https://railway.app) | |
| 3. "Deploy from GitHub repo" | |
| 4. Select your repository | |
| 5. 🎉 Railway auto-detects & deploys | |
| </td> | |
| <td width="33%"> | |
| ### 🎨 **Render** | |
| #### 💰 FREE TIER AVAILABLE | |
|  | |
| **✅ Benefits:** | |
| - 🔗 GitHub integration | |
| - 🔒 Free SSL certificates | |
| - 🔄 Automatic deploys | |
| - 📈 Scalable infrastructure | |
| - 💻 Custom domains | |
| - 📊 Real-time logs | |
| **🚀 Deploy Steps:** | |
| 1. Push to GitHub | |
| 2. Go to [render.com](https://render.com) | |
| 3. "New Web Service" | |
| 4. Connect GitHub repo | |
| 5. Set build: `pip install -r requirements.txt` | |
| 6. Set start: `python app.py` | |
| </td> | |
| </tr> | |
| </table> | |
| --- | |
| ### 🥇 **Recommended: Hugging Face Spaces** | |
| <div align="center"> | |
|  | |
| </div> | |
| | Feature | Hugging Face | Railway | Render | | |
| |---------|-------------|---------|---------| | |
| | 💰 **Cost** |  |  |  | | |
| | ⚡ **Setup Time** |  |  |  | | |
| | 🛠️ **Configuration** |  |  |  | | |
| | 🌍 **Global CDN** |  |  |  | | |
| | 📱 **Mobile Optimized** |  |  |  | | |
| ## ⚖️ Ethical Usage | |
| This tool is designed for: | |
| - ✅ Improving writing quality and naturalness | |
| - ✅ Educational purposes and learning | |
| - ✅ Understanding AI detection mechanisms | |
| - ✅ Research and development | |
| **Important Guidelines:** | |
| - 🚫 Do not use for plagiarism or academic dishonesty | |
| - 🚫 Do not violate institutional policies | |
| - 🚫 Do not misrepresent authorship | |
| - ✅ Maintain transparency about AI assistance | |
| - ✅ Follow academic integrity guidelines | |
| ## 🤝 Contributing | |
| Contributions are welcome! Please feel free to submit pull requests or open issues for: | |
| - Bug fixes | |
| - Feature enhancements | |
| - Algorithm improvements | |
| - Documentation updates | |
| ## 📄 License | |
| This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. | |
| ## 🙏 Acknowledgments | |
| - NLTK team for natural language processing tools | |
| - Hugging Face for hosting and deployment platform | |
| - Gradio team for the web interface framework | |
| - Open source community for various libraries and tools | |
| ## 📞 Support | |
| For questions, issues, or suggestions: | |
| - Open an issue on GitHub | |
| - Contact: [mishrikotkar.siddhant@gmail.com] | |
| --- | |
| **Disclaimer**: This tool is for educational and research purposes. Users are responsible for ensuring compliance with their institution's policies and maintaining academic integrity. | |