README.md

---
title: CPU Paraphraser Demo
emoji: 🏢
colorFrom: red
colorTo: blue
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: 'CPU-only Paraphraser '
---
# 🔄 Text Paraphraser  
[![Hugging Face Space](https://img.shields.io/badge/HuggingFace-Spaces-blue?logo=huggingface)](https://huggingface.co/spaces/your-username/text-paraphraser)  
[![Gradio UI](https://img.shields.io/badge/Gradio-5.31.0-green?logo=gradio)]  
[![Model](https://img.shields.io/badge/Model-Vamsi%2FT5_Paraphrase_Paws-orange)](https://huggingface.co/Vamsi/T5_Paraphrase_Paws)  
[![License-MIT](https://img.shields.io/badge/License-MIT-lightgrey)](LICENSE)

---

## 🚀 Overview  
Unlock **creative rewriting** with zero-shot **T5 paraphrasing**.  
Type any sentence and instantly generate multiple stylistic variations—**100% CPU**, no fine-tuning required.

> **AI buzzwords:**  
> • Sequence-to-Sequence • Zero-Shot Paraphrasing • Top-K Sampling • Temperature Control • Transformer-based NLP • Edge Inference • Cloud-Native Demo

---

## ✨ Key Features

| 🔑 Feature                   | 🔍 Description                                                  |
|------------------------------|----------------------------------------------------------------|
| **💬 Diverse Rewrites**         | Generate up to 5 alternative phrasings for any input sentence   |
| **⚙️ Sampling Controls**        | Uses `top_k=120`, `top_p=0.95` to balance diversity vs. quality |
| **💻 CPU-Only Inference**      | Runs on free-tier Spaces (2 vCPU / 16 GB RAM)                  |
| **🎨 Interactive UI**          | Gradio Blocks with input, slider, button, and result table     |
| **🔧 Zero-Config Deploy**       | Commit three files—Spaces auto-builds & hosts your demo        |

---

## 🏗️ How It Works

1. **User Input** – Provide a sentence to paraphrase.  
2. **T5-Paraphrase Pipeline** – Prepends “paraphrase:” and generates variants via sampling.  
3. **Result Formatting** – Displays each variant side-by-side in a table.  
4. **UI Rendering** – Gradio streams the outputs for instant review.

---

## 🛠️ Local Development

```bash
git clone https://github.com/your-username/text-paraphraser.git
cd text-paraphraser
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python app.py

## Latest Update

- Updated Gradio UI to version 5.31.0 for improved performance. - May 29, 2025 📝
- Improved result table formatting in the UI. 🚀 - June 02, 2025 📝
- Optimized CPU inference for faster response times. - June 01, 2025 📝
- Added support for longer input sentences. - May 31, 2025 📝
- Enhanced paraphrasing pipeline with new sampling parameters. - May 30, 2025 📝

**Website**: https://ghostainews.com/
**Discord**: https://discord.gg/BfA23aYz