# one.OS — Autonome Kognitive Ökosystem-Plattform

> **Das Ökosystem der Zukunft aus Heilbronn für Europa**

one.OS ist ein europäisches KI-Betriebssystem für Bildung, Wirtschaft und Innovation. Die Plattform verbindet Hochschulen, Unternehmen und Forschungseinrichtungen über ein Single Pane of Glass mit integrierter KI-Infrastruktur, Legal-Automatisierung und Agenten-Orchestrierung.

**Aktuelle Version:** `v1.7.23`

---

## Architektur

```
one.OS
├── Layer 0: ICP (Intelligent Campus Platform)   ← Single Pane of Glass
├── Layer 1: Liquid AI                            ← Distributed Compute (xPU-Pool)
├── Layer 2: Sovereign Trust & Legal Fabric       ← DCR, Verträge, Compliance-as-Code
├── Layer 3: ACE Intelligence                     ← Multi-Agenten-Orchestrierung
└── Layer 4: Ambient Interface                    ← Datei-Analyse, Dokument-Erstellung
```

**Stack:** Python 3 + Tornado (Backend) · Vanilla HTML/CSS/JS Single-File SPA (Frontend) · Port 8080

---

## Schnellstart (lokal)

```bash
# 1. Abhängigkeiten installieren
pip3 install -r one_os_webapp/requirements.txt

# 2. Backend starten
bash one_os_webapp/start.sh

# 3. Im Browser öffnen
open http://localhost:8080
```

---

## Deployment auf einem Server

Vollständige Anleitung → **[DEPLOY.md](DEPLOY.md)**

Kurzfassung für Ubuntu 22.04 LTS:

```bash
# Repository klonen
sudo git clone https://smart-city-digital-services.git.onstackit.cloud/Campus_IT/oneOS.git /opt/one-os

# Abhängigkeiten
sudo pip3 install -r /opt/one-os/one_os_webapp/requirements.txt --break-system-packages

# Systemd Service einrichten
sudo cp /opt/one-os/one-os.service /etc/systemd/system/one-os.service
sudo systemctl daemon-reload
sudo systemctl enable --now one-os

# Status prüfen
sudo systemctl status one-os
```

Updates einspielen:

```bash
sudo bash /opt/one-os/deploy.sh
```

---

## Projektstruktur

```
v1.7.23_git/
├── one.OS_local_v1.7.23.html   ← Aktuelle Frontend-Version (Single-File SPA)
├── one_os_webapp/
│   ├── app.py                  ← Tornado REST Backend
│   ├── requirements.txt        ← Python-Abhängigkeiten
│   ├── start.sh                ← Lokaler Start-Helper
│   └── static/
│       ├── index.html          ← Frontend (aktive Version für den Server)
│       └── intro_v1.7.6.html
├── one-os.service              ← Systemd Service Definition
├── deploy.sh                   ← Server-Deployment Script
├── push.sh                     ← Git Push Helper
├── git-setup.sh                ← Erstmaliges Git-Setup
├── DEPLOY.md                   ← Deployment-Dokumentation
├── AGENTS.md                   ← Agent-Architektur & Workflows
└── CLAUDE.md                   ← Projektkontext & Arbeitsprotokoll
```

---

## Workflow: Neue Version deployen

```bash
# 1. Lokal: neue HTML-Version erzeugen (z.B. v1.7.24)
# 2. Commit & Push
git add one.OS_local_v1.7.24.html
git commit -m "feat: v1.7.24 - <kurze Beschreibung>"
git push origin main

# 3. Auf dem Server
sudo bash /opt/one-os/deploy.sh
```

Das `deploy.sh`-Script kopiert automatisch die neueste `one.OS_local_v*.html` als `static/index.html`.

---

## API-Übersicht

| Endpunkt | Methode | Beschreibung |
|---|---|---|
| `/api/status` | GET | System-Status aller Layer |
| `/api/metrics` | GET | Live KPI-Metriken |
| `/api/liquid-ai/resources` | GET | xPU-Pool Auslastung |
| `/api/liquid-ai/allocate` | POST | Workload allokieren |
| `/api/legal/clean-rooms` | GET/POST | Dynamic Clean Rooms |
| `/api/legal/contracts` | GET/POST | Vertragsgeneration |
| `/api/legal/compliance/check` | POST | Compliance-Check |
| `/api/legal/ip/protect` | POST | IP-Schutz registrieren |
| `/api/ace/agents` | GET | Agenten-Status |
| `/api/ace/orchestrate` | POST | Multi-Agenten-Task starten |
| `/api/icp/users` | GET | Nutzer & Organisationen |
| `/api/icp/connect` | POST | Akteure verbinden |

---

## Logs & Monitoring

```bash
# Live-Logs
sudo journalctl -u one-os -f

# Service-Status
sudo systemctl status one-os
```

---

## Entwickelt in Heilbronn

Primäre Partner: HHN · TUM · Porsche AG · Schwarz Digits · Fraunhofer · IPAI · HLRS · LRZ · STACKIT