README.md

---
title: SAAP - satware AI Platform
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
app_port: 7860
---

# SAAP - satware AI Autonomous Agent Platform

**Multi-Agent AI Platform** - FastAPI backend + Vue.js frontend running on Hugging Face Spaces.

## 🚀 Features

- **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

- **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
- `GET /api` - API health check
- `GET /api/v1/agents` - List all agents
- `POST /api/v1/agents/{id}/chat` - Chat with specific agent
- `GET /docs` - Interactive API documentation (Swagger UI)

## 🔧 Local Development

```bash
# Backend
cd backend
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

# Frontend
cd frontend
npm install
npm run dev
```

## 🌐 Deployment

This version is optimized for Hugging Face Spaces:
- Single Dockerfile with multi-stage build
- FastAPI serves both API and frontend
- Minimal dependencies and clean architecture
- Environment variables via HF Secrets

---

**Built with ❤️ by satware AG**  
Master Thesis Project - Applied Computer Science