saap-deploy / huggingface /README.md
Hwandji's picture
fix(huggingface): Simplify deployment - direct FastAPI on port 7860
81c1780
metadata
title: SAAP - satware Autonomous Agent Platform
emoji: πŸ€–
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
license: mit
app_port: 7860

πŸš€ SAAP - satware Autonomous Agent Platform

Local autonomous multi-agent platform for specialized AI agents.

Features

  • Multi-Agent System with specialized agents (Jane, John, Lara, Luna, Leon, Theo, Justus)
  • Hybrid Provider Support (OpenRouter + Colossus fallback)
  • Real-time WebSocket updates
  • SQLite Database for persistence
  • Vue.js Frontend + FastAPI Backend

Quick Start

The application runs on Port 7860 (HuggingFace standard).

Endpoints

  • Frontend: http://localhost:7860/ (Vue.js Dashboard)
  • API Root: http://localhost:7860/api
  • API Docs: http://localhost:7860/docs
  • Health Check: http://localhost:7860/health
  • Agents API: http://localhost:7860/api/v1/agents

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  FastAPI on Port 7860                   β”‚
β”‚  β”œβ”€ /api/*        β†’ Backend API         β”‚
β”‚  β”œβ”€ /docs         β†’ API Documentation   β”‚
β”‚  β”œβ”€ /health       β†’ Health Check        β”‚
β”‚  └─ /*            β†’ Vue.js Frontend      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Development

Built with:

  • Backend: Python 3.11, FastAPI, SQLAlchemy
  • Frontend: Vue.js 3, Vite, TailwindCSS
  • Database: SQLite (production) / PostgreSQL (optional)

License: MIT
Organization: satware AG
Website: https://satware.ai