diff --git a/README.md b/README.md
index 595889480..3177a63aa 100644
--- a/README.md
+++ b/README.md
@@ -1,65 +1,311 @@
-# PictoPy
+
-PictoPy is an advanced desktop gallery application that combines the power of Tauri, React, and Rust for the frontend with a Python backend for sophisticated image analysis and management.
+# πΈ PictoPy
-# Want to Contribute? π
+**Your Intelligent Photo Gallery - Powered by AI, Protected by Privacy**
-
+[](LICENSE)
+[](https://discord.gg/hjUhu33uAn)
+[](https://tauri.app)
+[](https://python.org)
+[](https://reactjs.org)
+[](https://typescriptlang.org)
-1. First, join the **[Discord Server](https://discord.gg/hjUhu33uAn) (Go to Projects->PictoPy)** to chat with everyone.
-2. For detailed setup instructions, coding guidelines, and the contribution process, please check out our [CONTRIBUTING.md](./CONTRIBUTING.md) file.
+[Features](#-features) β’ [Screenshots](#-screenshots) β’ [Getting Started](#-getting-started) β’ [Contributing](#-contributing) β’ [Documentation](#-documentation)
-# Architecture
+
+
+### Home Gallery View
+
+
+### AI-Powered Tagging
+
+
+### Settings & Configuration
+
+
+
+
+---
+
+## π οΈ Technical Stack
+
+
+
+|
### Frontend
+- **Framework**: React 18 + TypeScript
+- **Desktop**: Tauri 2.0
+- **Styling**: Tailwind CSS
+- **UI Components**: ShadCN UI
+- **State Management**: Redux Toolkit
+- **Build Tool**: Vite
+- **Routing**: React Router
+
+ |
+
+
+### Backend
+- **Python API**: FastAPI
+- **Rust Backend**: Tauri Core
+- **Database**: SQLite
+- **AI/ML**: ONNX Runtime, OpenCV
+- **Object Detection**: YOLOv11
+- **Face Recognition**: FaceNet
+- **Async Processing**: asyncio
+
+ |
+
+
+
+---
+
+## π Getting Started
+
+### Prerequisites
+
+Before you begin, ensure you have the following installed:
+
+- **Node.js** 18+ and npm/yarn
+- **Python** 3.11+
+- **Rust** 1.70+ (for Tauri)
+- **Git**
+
+### Quick Setup
+
+#### Option 1: Automated Setup (Recommended)
+
+**Windows & Ubuntu/Debian:**
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/PictoPy.git
+cd PictoPy
+
+# Run setup script
+# Windows (PowerShell):
+.\scripts\setup.ps1
+
+# Linux/macOS:
+./scripts/setup.sh
+```
+
+#### Option 2: Manual Setup
+
+For detailed manual setup instructions for all operating systems, see our [Manual Setup Guide](docs/Manual_Setup_Guide.md).
+
+### Running the Application
+
+1. **Start the Python Backend:**
+ ```bash
+ cd backend
+ python main.py
+ ```
+
+2. **Start the Frontend (in a new terminal):**
+ ```bash
+ cd frontend
+ npm run tauri dev
+ ```
-- **Tauri**: Enables building the desktop application
-- **React**: Used for creating the user interface
-- **Rust**: Powers the backend, which the frontend communicates with through Tauri's API
-
-### Backend (Python)
-
-- **FastAPI**: Serves as the API framework
-- **SQLite**: Database for storing metadata and embeddings
-- **YOLO**: Used for object detection
-- **FaceNet**: Generates face embeddings
-- **ONNX Runtime**: Runs the models efficiently
-- **DBSCAN**: Performs clustering for face embeddings
-
-### Backend (Rust via Tauri)
-
-Handles file system operations and provides a secure bridge between the frontend and local system.
-
-## Features
-
-- Smart tagging of photos based on detected objects, faces, and their recognition
-- Traditional gallery features of album management
-- Advanced image analysis with object detection and facial recognition
-- Privacy-focused design with offline functionality
-- Efficient data handling and parallel processing
-- Smart search and retrieval
-- Cross-platform compatibility
-
-## Technical Stack
-
-| Component | Technology |
-| ----------------- | -------------------- |
-| Frontend | React |
-| Desktop Framework | Tauri |
-| Rust Backend | Rust |
-| Python Backend | Python |
-| Database | SQLite |
-| Image Processing | OpenCV, ONNX Runtime |
-| Object Detection | YOLOv11 |
-| Face Recognition | FaceNet |
-| API Framework | FastAPI |
-| State Management | Redux Toolkit |
-| Styling | Tailwind CSS |
-| Routing | React Router |
-| UI Components | ShadCN |
-| Build Tool | Vite |
-| Type Checking | TypeScript |
+The application will launch automatically!
---
-Our Code of Conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+## π Architecture
+
+```
+βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+β Desktop Application β
+β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
+β β React Frontend (TypeScript) β β
+β β β’ Modern UI Components (ShadCN) β β
+β β β’ State Management (Redux) β β
+β β β’ Routing & Navigation β β
+β βββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββ β
+β β Tauri IPC β
+β βββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββ β
+β β Rust Backend (Tauri Core) β β
+β β β’ File System Operations β β
+β β β’ Secure System Bridge β β
+β β β’ Native OS Integration β β
+β βββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββ β
+ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+ β HTTP/REST API
+βββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββ
+β Python Backend (FastAPI) β
+β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββββββ β
+β β AI Models β β Database β β Image Analysis β β
+β β β’ YOLOv11 β β SQLite β β β’ OpenCV β β
+β β β’ FaceNet β β β’ Metadata β β β’ ONNX β β
+β β β’ DBSCAN β β β’ Embeddingsβ β β’ Processing β β
+β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββββββ β
+ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+```
+
+---
+
+## π€ Contributing
+
+We welcome contributions from developers of all skill levels! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
+
+### How to Contribute
+
+1. **Join our [Discord Server](https://discord.gg/hjUhu33uAn)** (Projects β PictoPy) to connect with the community
+2. Check out our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
+3. Review our [Code of Conduct](./CODE_OF_CONDUCT.md)
+4. Fork the repository and create your feature branch
+5. Make your changes and submit a pull request
+
+### Development Workflow
+
+```bash
+# 1. Fork and clone the repository
+git clone https://github.com/yourusername/PictoPy.git
+cd PictoPy
+
+# 2. Create a feature branch
+git checkout -b feature/amazing-feature
+
+# 3. Make your changes and test
+npm test # Frontend tests
+cd backend && pytest # Backend tests
+
+# 4. Commit and push
+git commit -m "Add amazing feature"
+git push origin feature/amazing-feature
+
+# 5. Open a Pull Request
+```
+
+### Testing
+
+**Frontend:**
+```bash
+cd frontend
+npm test # Run tests
+npm run test:watch # Watch mode
+```
+
+**Backend:**
+```bash
+cd backend
+pytest # Run all tests
+pytest tests/test_albums.py # Run specific test
+```
+
+**Rust (Tauri):**
+```bash
+cd frontend/src-tauri
+cargo test
+```
+
+---
+
+## π Documentation
+
+- π [Full Documentation](https://AOSSIE-Org
+PictoPy.github.io/PictoPy)
+- π§ [Manual Setup Guide](docs/Manual_Setup_Guide.md)
+- π [Script Setup Guide](docs/Script_Setup_Guide.md)
+- ποΈ [Architecture Overview](docs/overview/architecture.md)
+- β¨ [Features Details](docs/overview/features.md)
+- π¨ [Frontend Documentation](docs/frontend/)
+- π [Backend Documentation](docs/backend/)
+
+---
+
+## πΊοΈ Roadmap
+
+- [ ] π¬ Video support and analysis
+- [ ] π Multi-language support
+- [ ] π± Mobile companion app
+- [ ] βοΈ Optional cloud sync (encrypted)
+- [ ] π¨ Custom AI model training
+- [ ] π Advanced similarity search
+- [ ] π Photo analytics dashboard
+- [ ] π€ Shared albums (local network)
+
+---
+
+## π License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## π Acknowledgments
+
+- Thanks to all our [contributors](https://github.com/yourusername/PictoPy/graphs/contributors)
+- Built with amazing open-source technologies
+- Special thanks to the Tauri, React, and FastAPI communities
+
+---
+
+## π Links
+
+- π [Website](https://pictopy.dev) (if available)
+- π¬ [Discord Community](https://discord.gg/hjUhu33uAn)
+- π [Issue Tracker](https://github.com/yourusername/PictoPy/issues)
+- π§ [Contact Us](mailto:contact@pictopy.dev)
+
+---
+
+
+
+**Made with β€οΈ by the PictoPy Community**
+
+β Star us on GitHub β it helps!
+
+[Report Bug](https://github.com/yourusername/PictoPy/issues) Β· [Request Feature](https://github.com/yourusername/PictoPy/issues) Β· [Join Discord](https://discord.gg/hjUhu33uAn)
+
+