oneOS/README.md
2026-04-07 20:32:21 +00:00

144 lines
4.2 KiB
Markdown

# 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