Update README.md

README.md

@@ -1,13 +1,95 @@
 ---
-title: Humanizer App
-emoji: 🐨
-colorFrom: green
-colorTo: blue
-sdk: gradio
-sdk_version: 5.35.0
+title: Free Text Humanizer
+emoji: ✨
+colorFrom: pink
+colorTo: purple
+sdk: streamlit
+sdk_version: 1.36.0
 app_file: app.py
 pinned: false
-license: lgpl-3.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Free Text Humanizer ✨
+
+## Rewrite text for a more natural, human-like tone using publicly available models.
+
+This Streamlit application provides a user-friendly interface to "humanize" text by rewriting it using a powerful text-to-text generation model.
+
+---
+
+### 🚀 How to Use
+
+1.  **Paste your text:** Enter the text you want to make more natural into the provided text area.
+2.  **Click "Humanize Text":** The application will process your text and display a rewritten version.
+
+---
+
+### 💡 How It Works
+
+The "Text Humanizer" uses a **T5-base** model, a powerful text-to-text transformer from Hugging Face. When you provide text, the model paraphrases it, aiming to:
+
+* Vary sentence structures and vocabulary.
+* Introduce more natural phrasing.
+* Potentially make the text less predictable to language models.
+
+**Important Note:** This tool is designed to *rewrite* text for improved naturalness. It **does not guarantee** that the output will bypass AI detection tools. The effectiveness of "humanization" is subjective and depends on the original text's characteristics and the specific AI detector being used.
+
+---
+
+### ⚠️ Important Considerations
+
+* **Rewriting, Not Undetectable AI:** This tool focuses on making text sound more natural and less robotic. It is not designed to create content that is guaranteed to bypass AI detection systems, as that is an ongoing and complex challenge.
+* **Context and Nuance:** While the model is powerful, it may not always capture the full nuance or specific stylistic elements of human writing, especially for highly creative or domain-specific content.
+* **Length Limitations:** Very long texts might be truncated by the model's input limits, which could affect the coherence of the rewritten output.
+
+---
+
+### ⚙️ Installation (for Local Development)
+
+To run this application locally, follow these steps:
+
+1.  **Clone the repository:**
+    ```bash
+    git clone [https://github.com/your-username/your-repo-name.git](https://github.com/your-username/your-repo-name.git) # Replace with your actual repo URL
+    cd your-repo-name
+    ```
+2.  **Create a virtual environment (recommended):**
+    ```bash
+    python -m venv venv
+    # On Windows:
+    .\venv\Scripts\activate
+    # On macOS/Linux:
+    source venv/bin/activate
+    ```
+3.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+    *(Refer to `requirements.txt` for specific versions, especially for `torch` if you need CUDA support.)*
+4.  **Run the Streamlit app:**
+    ```bash
+    streamlit run app.py
+    ```
+
+---
+
+### 🤝 Contributing
+
+Contributions are welcome! If you have suggestions for improvements, new features, or bug fixes, please feel free to:
+
+1.  Fork the repository.
+2.  Create a new branch (`git checkout -b feature/your-feature-name`).
+3.  Make your changes.
+4.  Commit your changes (`git commit -m 'Add new feature'`).
+5.  Push to the branch (`git push origin feature/your-feature-name`).
+6.  Open a Pull Request.
+
+---
+
+### License
+
+This project is open-source and available under the [MIT License](LICENSE). *(Assuming MIT, replace if different)*
+
+---
+
+Made with ❤️ using [Streamlit](https://streamlit.io/) and [Hugging Face Transformers](https://huggingface.co/docs/transformers/).