File size: 1,632 Bytes
4343907
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8dfa761
4343907
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
---
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