Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

VHumanize

VHumanize is a web-based tool for transforming AI-generated text into natural, human-like content and detecting AI-generated text. It provides advanced paraphrasing, rewriting, and AI detection features, leveraging state-of-the-art NLP models and a modern Svelte frontend.

✨ Features

  • πŸ” AI Detection: Detects AI-generated content at line and sentence levels, with visual highlighting and detailed statistics
  • πŸ”„ Humanization Pipeline: Two-step process (Paraphrasing + Rewriting) to convert AI text into more human-like writing
  • πŸ€– Multi-Model Support: Choose from multiple transformer-based models (T5, BART, Pegasus, etc.) for paraphrasing and rewriting
  • ⚑ Enhanced Mode: Optionally use advanced prompts and NLP techniques for higher-quality rewriting
  • πŸ”¬ Combined Humanize & Verify: Instantly humanize text and check for AI traces in a single workflow
  • πŸ“‹ Copy & Share: Easily copy results to clipboard
  • πŸ“± Responsive UI: Clean, modern interface built with SvelteKit and Vite

πŸ› οΈ Tech Stack

Backend

  • Python 3.11+
  • Flask - Web framework
  • NLTK, spaCy, TextBlob - NLP processing and advanced rewriting
  • Transformers (HuggingFace) - Paraphrasing and rewriting models (T5, BART, Pegasus)

Frontend

  • SvelteKit - Modern, component-based UI framework
  • Vite - Fast build tool and dev server
  • Svelte Stores - Reactive state management
  • Lucide Icons - UI icons

πŸ“ Project Structure

humanizer/
β”œβ”€β”€ detector.py # AI detection backend logic
β”œβ”€β”€ download_models.py # Script to download required models
β”œβ”€β”€ main.py # Backend server entry point
β”œβ”€β”€ paraphraser.py # Paraphrasing logic and model management
β”œβ”€β”€ rewriter.py # Advanced rewriting and NLP enhancements
β”œβ”€β”€ requirements.txt # Python dependencies
β”œβ”€β”€ README.md
β”œβ”€β”€ frontend/
β”‚ β”œβ”€β”€ package.json
β”‚ β”œβ”€β”€ vite.config.js
β”‚ β”œβ”€β”€ svelte.config.js
β”‚ β”œβ”€β”€ src/
β”‚ β”‚ β”œβ”€β”€ app.html
β”‚ β”‚ β”œβ”€β”€ lib/
β”‚ β”‚ β”‚ β”œβ”€β”€ script.js # Frontend logic and API calls
β”‚ β”‚ β”‚ └── style.css # Main CSS
β”‚ β”‚ └── routes/
β”‚ β”‚ └── +page.svelte # Main Svelte page
β”‚ └── static/
β”‚ └── favicon.png
└── __pycache__/

πŸš€ Quick Start

Prerequisites

  • Python 3.11+
  • Node.js 16+
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/vardhin/vhumanize.git
    cd vhumanize
  2. Backend Setup

    # Install Python dependencies
    pip install -r requirements.txt
    # Download required models
    python download_models.py
    # Start the backend server
    python main.py

    The API server will start at http://localhost:8080

  3. Frontend Setup

    # Navigate to frontend directory
    cd frontend
    # Install Node.js dependencies
    npm install
    # Start the development server
    npm run dev

    The frontend will be available at http://localhost:5173

πŸ“‘ API Endpoints

Endpoint Description
/paraphrase_only Paraphrase text with selected model
/rewrite_only Rewrite text for humanization
/paraphrase_multi Paraphrase with multiple models
/paraphrase_all Paraphrase with all available models
/highlight_ai Highlight detected AI-generated sentences/lines
/humanize_and_check Humanize and verify in one step
/models List available models
/health Backend health check

βš™οΈ Configuration

  • Model Selection: Choose or recommend models for paraphrasing/humanization
  • Enhanced Mode: Toggle for higher-quality, slower rewriting
  • Detection Threshold: Adjust sensitivity for AI detection

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).

You are free to:

  • Share β€” copy and redistribute the material in any medium or format
  • Adapt β€” remix, transform, and build upon the material

Under the following terms:

  • Attribution β€” You must give appropriate credit to Vardhin, provide a link to the license, and indicate if changes were made
  • NonCommercial β€” You may not use the material for commercial purposes

See the LICENSE file for details or visit Creative Commons for more information.

πŸ™ Acknowledgments

πŸ› Issues & Support

If you encounter any issues or have questions, please open an issue on GitHub.


Made with ❀️ by Vardhin

About

AI text humanization tool with detection capabilities. Transform AI-generated content into natural, human-like writing using advanced NLP models (T5, BART, Pegasus). Features real-time AI detection, multi-model paraphrasing, and a modern Svelte frontend.

Topics

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /