docs: Add HF Spaces metadata to README

README.md

@@ -1,35 +1,47 @@
+---
+title: SAAP - satware AI Platform
+emoji: 🤖
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+app_port: 7860
+---
+
 # SAAP - satware AI Autonomous Agent Platform
 
-**Hugging Face Deployment** - Simple Docker setup with FastAPI serving both backend and frontend.
+**Multi-Agent AI Platform** - FastAPI backend + Vue.js frontend running on Hugging Face Spaces.
 
-## 🚀 Quick Start
+## 🚀 Features
 
-This application runs on Hugging Face Spaces using a single Docker container with:
-- **FastAPI backend** (Python 3.11)
-- **Vue.js frontend** (served as static files)
-- **Port 7860** (Hugging Face Spaces default)
+- **Multi-Agent Management**: Create and manage AI agents with different personalities
+- **OpenRouter Integration**: Connect to various LLM models (GPT-4, Claude, etc.)
+- **Real-time Chat**: WebSocket-based communication with agents
+- **Cost Tracking**: Monitor API usage and costs
+- **Modern UI**: Vue.js frontend with Tailwind CSS
 
-## 🐳 Architecture
+## 🏗️ Architecture
 
-- **Dockerfile**: Single-stage build that compiles frontend and starts FastAPI
-- **Backend**: `/app/backend/` - FastAPI server with agent management
-- **Frontend**: `/app/frontend/dist/` - Pre-built Vue.js app served by FastAPI
+- **Backend**: FastAPI (Python 3.11) serving API and static files
+- **Frontend**: Vue.js + Vite (pre-built, served as static files)
+- **Port**: 7860 (Hugging Face Spaces default)
+- **Database**: SQLite for agent configurations
 
 ## 📡 API Endpoints
 
-- `GET /` - Vue.js frontend (static files)
-- `GET /api` - API status
+- `GET /` - Vue.js frontend
+- `GET /api` - API health check
 - `GET /api/v1/agents` - List all agents
-- `POST /api/v1/agents/{id}/chat` - Chat with agent
-- `GET /docs` - Interactive API documentation
+- `POST /api/v1/agents/{id}/chat` - Chat with specific agent
+- `GET /docs` - Interactive API documentation (Swagger UI)
 
-## 🔧 Development
+## 🔧 Local Development
 
 ```bash
 # Backend
 cd backend
 pip install -r requirements.txt
-uvicorn main:app --reload
+uvicorn main:app --reload --port 8000
 
 # Frontend
 cd frontend
@@ -37,10 +49,15 @@ npm install
 npm run dev
 ```
 
-## 📦 Deployment
+## 🌐 Deployment
 
-Deployed on [Hugging Face Spaces](https://huggingface.co/spaces/Hwandji/saap-huggingface)
+This version is optimized for Hugging Face Spaces:
+- Single Dockerfile with multi-stage build
+- FastAPI serves both API and frontend
+- No nginx or supervisord required
+- Environment variables via HF Secrets
 
 ---
 
-Built with ❤️ by satware AG
+**Built with ❤️ by satware AG**  
+Master Thesis Project - Applied Computer Science