Update README.md

README.md

@@ -9,4 +9,71 @@ license: mit
 short_description: A minimal Node.js + Gemini-powered web app to analyze text.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# 🕵️ FakeDetect - OSINT Intelligence Analyzer
+
+FakeDetect is a real-time Open Source Intelligence (OSINT) web application that uses Google Gemini AI to analyze and visualize multilingual social media and news content.
+
+## ✨ Features
+
+- 🧠 AI-powered content interpretation using Gemini 1.5 Flash
+- 📊 Sentiment analysis (positive / neutral / negative breakdown)
+- 🌐 Network influence graph for user/entity clustering
+- 📌 Structured report output (JSON + HTML)
+- 💾 Exportable report as modern dark-mode HTML
+- 💬 Multilingual support (EN, DE, ES, FR, RU)
+
+## 🔧 Tech Stack
+
+- **Frontend:** HTML + TailwindCSS
+- **Backend:** Node.js (Express) + Python (matplotlib, networkx)
+- **AI:** Google Generative AI (Gemini)
+- **Deployment:** Hugging Face Spaces (Docker SDK)
+
+## 🚀 Quick Start (Docker)
+
+```bash
+git clone https://github.com/Basti-devel/fakedetect.git
+cd fakedetect
+
+# Build the container
+docker build -t fakedetect .
+
+# Run the app
+docker run -p 7860:7860 fakedetect
+```
+
+Access the app at: [http://localhost:7860](http://localhost:7860)
+
+## 📁 Project Structure
+
+```
+├── app.js                  # Node.js backend (Express)
+├── render_report.py        # Python rendering (charts + HTML)
+├── index.html              # Frontend interface
+├── osint_dark_template.html # Dark HTML template for reports
+├── requirements.txt        # Python dependencies
+├── package.json            # Node dependencies
+├── space.yaml              # Hugging Face Space config
+├── Dockerfile              # Unified deployment container
+└── /tmp                    # Runtime output directory
+```
+
+## 🛡 Ethics & Compliance
+
+FakeDetect adheres to:
+- 📝 GDPR and digital privacy principles
+- 🕊️ Journalistic ethics and OSINT standards
+- 🛑 Avoids speculative conclusions, hate speech, or bias
+
+## 🧠 Sample Use Cases
+
+- 🗞 Investigative journalism
+- 🛡 NGO threat reporting
+- 🧵 Telegram/Reddit sentiment tracking
+- 🧾 Misinformation early detection
+
+---
+
+© 2025 FakeDetect by Sebastian Friedrich Nestler. Built with ❤️ for responsible intelligence analysis.
+