README.md

metadata

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

# 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