README: Add comparison table, badges, and improved structure for launch

Author: PurpleDoubleD

README.md

@@ -1,22 +1,58 @@
-# Locally Uncensored
+<div align="center">
 
-**Private, local AI chat & media generation. No cloud. No censorship. No data collection.**
+# 🔓 Locally Uncensored
 
-A beautiful, feature-rich web app for running uncensored AI models entirely on your own hardware. Chat with abliterated LLMs via Ollama and generate images/videos with ComfyUI — all offline, all private.
+**The only local AI app that does Chat + Images + Video — all in one beautiful UI.**
+
+No cloud. No censorship. No data collection. Just you and your AI.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub stars](https://img.shields.io/github/stars/PurpleDoubleD/locally-uncensored?style=social)](https://github.com/PurpleDoubleD/locally-uncensored/stargazers)
+[![GitHub last commit](https://img.shields.io/github/last-commit/PurpleDoubleD/locally-uncensored)](https://github.com/PurpleDoubleD/locally-uncensored/commits)
+
+<!-- Add screenshot/GIF here -->
+<!-- ![Locally Uncensored Screenshot](docs/screenshot.png) -->
+
+[Getting Started](#-quick-start) · [Features](#-features) · [Why This App?](#-why-locally-uncensored) · [Contributing](#contributing)
+
+</div>
 
 ---
 
-## Features
+## ❓ Why Locally Uncensored?
+
+Tired of switching between Ollama for chat, ComfyUI for images, and another tool for video? Frustrated with bloated UIs that need Docker and a PhD to set up?
+
+**Locally Uncensored** is the all-in-one solution. One app. One setup. Everything local.
+
+### How it compares
+
+| Feature | Locally Uncensored | Open WebUI | LM Studio | SillyTavern |
+|---------|:-:|:-:|:-:|:-:|
+| AI Chat | ✅ | ✅ | ✅ | ✅ |
+| Image Generation | ✅ | ❌ | ❌ | ❌ |
+| Video Generation | ✅ | ❌ | ❌ | ❌ |
+| Uncensored by Default | ✅ | ❌ | ❌ | ⚠️ |
+| One-Click Setup | ✅ | ❌ (Docker) | ✅ | ❌ (Node.js) |
+| 25+ Built-in Personas | ✅ | ❌ | ❌ | ⚠️ (manual) |
+| Modern UI | ✅ | ✅ | ✅ | ❌ |
+| Open Source | ✅ | ✅ | ❌ | ✅ |
+| No Docker Required | ✅ | ❌ | ✅ | ✅ |
+| 100% Offline | ✅ | ✅ | ✅ | ✅ |
 
-- **Uncensored AI Chat** — Run abliterated models locally with full control
-- **25+ Personas** — From Helpful Assistant to Roast Master, choose your AI personality
+---
+
+## ✨ Features
+
+- **Uncensored AI Chat** — Run abliterated models locally with zero restrictions
 - **Image Generation** — Text-to-image via ComfyUI with full parameter control
-- **Video Generation** — Text-to-video support with frame and FPS settings
-- **Thinking Display** — See the AI's reasoning process in collapsible blocks
-- **Model Manager** — Install, manage, and switch between models with one click
-- **Discover Models** — Browse and install uncensored models from the Ollama registry
-- **Dark/Light Mode** — Beautiful UI with glassmorphism design
-- **100% Local** — Everything runs on your machine, nothing leaves your network
+- **Video Generation** — Text-to-video with Wan 2.1/2.2 and AnimateDiff support
+- **25+ Personas** — From Helpful Assistant to Roast Master, ready out of the box
+- **Model Manager** — Browse, install, and switch models with one click
+- **Discover Models** — Find and install uncensored models from the Ollama registry
+- **Thinking Display** — See the AI's reasoning in collapsible blocks
+- **Dark/Light Mode** — Beautiful glassmorphism UI that actually looks good
+- **100% Local** — Everything runs on your machine, nothing touches the internet
 - **Conversation History** — All chats saved locally in your browser
 
 ## Tech Stack
@@ -26,7 +62,9 @@ A beautiful, feature-rich web app for running uncensored AI models entirely on y
 - **AI Backend**: Ollama (text), ComfyUI (images/video)
 - **Build**: Vite 8
 
-## Quick Start
+---
+
+## 🚀 Quick Start
 
 ### One-Command Setup (Windows)
 
@@ -68,12 +106,15 @@ Open **http://localhost:5173** — the app recommends models on first launch.
 
 ### One-Click Start (Windows)
 
-Use `start.bat` to launch everything together:
 ```batch
 start.bat
 ```
 
-## Model Auto-Detection
+Launches Ollama + ComfyUI + the app in one go.
+
+---
+
+## 🧠 Model Auto-Detection
 
 The app automatically detects all installed models across all backends — no manual configuration needed:
 
@@ -83,7 +124,37 @@ The app automatically detects all installed models across all backends — no ma
 
 Just install models in the standard locations and the app picks them up.
 
-## Configuration
+## 🎭 Recommended Models
+
+### Text (Ollama)
+
+| Model | Size | VRAM | Best For |
+|-------|------|------|----------|
+| Llama 3.1 8B Abliterated | 5.7 GB | 6 GB | Fast all-rounder |
+| Qwen3 8B Abliterated | 5.2 GB | 6 GB | Coding |
+| Mistral Nemo 12B Abliterated | 6.8 GB | 8 GB | Multilingual |
+| DeepSeek R1 8B Abliterated | 5 GB | 6 GB | Reasoning |
+| Qwen3 14B Abliterated | 9 GB | 12 GB | High intelligence |
+
+### Image (ComfyUI)
+
+| Model | VRAM | Notes |
+|-------|------|-------|
+| Juggernaut XL V9 | 8 GB | Best photorealistic |
+| FLUX.1 Schnell | 10-12 GB | State-of-the-art |
+| Pony Diffusion V6 XL | 8 GB | Anime/stylized |
+
+### Video (ComfyUI)
+
+| Model | VRAM | Output | Notes |
+|-------|------|--------|-------|
+| Wan 2.1 T2V 1.3B | 8-10 GB | 480p WEBP | Built-in nodes, no extras needed |
+| Wan 2.2 T2V 14B (FP8) | 10-12 GB | 480-720p | Higher quality, quantized |
+| AnimateDiff v3 + SD1.5 | 6-8 GB | MP4 | Requires AnimateDiff custom nodes |
+
+---
+
+## ⚙️ Configuration
 
 ### Environment Variables
 
@@ -101,7 +172,9 @@ COMFYUI_PATH=C:\path\to\your\ComfyUI
 - **Max Tokens** — Limit response length (0 = unlimited)
 - **Theme** — Dark or Light mode
 
-## Project Structure
+---
+
+## 📁 Project Structure
 
 ```
 src/
@@ -119,6 +192,8 @@ src/
   lib/          # Constants & utilities
 ```
 
+---
+
 ## Contributing
 
 Contributions are welcome! Feel free to open issues and pull requests.
@@ -135,4 +210,10 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**Built with privacy in mind. Your data stays on your machine.**
+<div align="center">
+
+**Built with privacy in mind. Your data stays on your machine.** 🔒
+
+If you find this useful, consider giving it a ⭐
+
+</div>