Auf Aipokit aufbauen
Eine REST-API und eine Workspace-MCP-Oberfläche über einem gemeinsamen Kern mit Governance — dieselben Operationen hinter jedem Studio und Ask (KI im Produkt). Richten Sie eine REST-Integration oder einen externen Agenten auf einen Workspace und er kann Dateien erstellen, Prozesse steuern, Medien verwalten und veröffentlichen. Selbst gehostet auf Ihrer Infrastruktur, mit Datenbank-Isolation pro Account und ohne Vendor-Lock-in.
Alles, was Sie zur Integration brauchen
Eine Aktion = eine Service-Funktion — identisch für UI, REST-API und Agenten über MCP.
Architektur
Schlanker Datei- und Medien-Kern, Memory-Graph, Agenten-Runtime und Prozess-Engine.
Schnelleinstieg
Workspace einrichten, Dateien erstellen oder importieren, Agenten anbinden — drei Schritte.
API & MCP
REST ist der stabile Vertrag; Workspace MCP ist ein dünner Agenten-Adapter über denselben Operationen.
Agenten-Integration
Eigenen Agenten mitbringen — Claude Desktop oder Custom Loop — und einen Workspace über MCP betreiben.
Self-Hosting
Docker-Image, ein privater Authoring-Node plus N öffentliche Delivery-Nodes, DB pro Account.
Paritätsmodell
Kein vorgetäuschter Erfolg und keine private Hintertür — jede Oberfläche ruft denselben Service.
Schlanker Kern, reiche Oberflächen.
Im Zentrum steht ein Datei- und Medien-Kern mit Memory-Graph, Agenten-Runtime und Prozess-Engine. Studios sind SPA-Authoring-Oberflächen über denselben Service-Verträgen — klare Hülle über einem nüchternen, wahrhaftigen Kern. Endnutzer-Output wird als statische, JS-freie Seiten ausgeliefert, die kein Authoring-Bundle zum Rendern brauchen.
Architektur
Der Stack
| Ebene | Technologie |
|---|---|
| Sprache | Rust (stable) |
| Web-Framework | Axum 0.8 |
| Templates | Askama 0.13 (SSR, typsicher) |
| Datenbank | SQLite via sqlx (Compile-Time geprüft) |
| Sessions | tower-sessions 0.14 + SQLite Store |
| Auth | OIDC (Casdoor empfohlen) |
| CSS | TailwindCSS v4 + DaisyUI |
| Video | FFmpeg (HLS) + MediaMTX (RTMP) |
| Observability | OpenTelemetry 0.31 + OTLP/gRPC |
Workspace-Crate-Architektur
Aipokit ist ein Cargo-Workspace mit 34 Crates, nach Domäne organisiert:
crates/
common/ # Gemeinsame Typen, Storage, Datenbank
media-core/ # Medienerkennung, EXIF-Extraktion
media-manager/ # Upload, Auslieferung, Suche, CRUD
video-manager/ # HLS-Transcoding (8-stufige Pipeline)
access-control/ # 4-stufiges Berechtigungsmodell
access-codes/ # Teilbare Zugangslinks
access-groups/ # Team-Rollen und Einladungen
user-auth/ # OIDC + Session-Management
workspace-manager/ # Workspace-Browser und Ordner-Typen
vault-manager/ # Storage-Vault-Isolation
site-generator/ # Astro-Site-Generierung
course/ # Kurs-Viewer + Präsentationen
...und 22 weitereDas Dual-Use-Muster
Jedes App-Crate implementiert das FolderTypeRenderer-Trait für den eingebetteten Modus (im Workspace-Browser) und exportiert einen Router für den Standalone-Modus (eigene URL). Dieselbe Logik, dieselben Templates, zwei Deployment-Modi.
Storage-Layout
storage/
workspaces/{workspace_id}/ # File-Browser-Inhalte
folder-a/ # Regulärer Ordner
media-gallery/ # Typisierter Ordner (media-server)
vaults/{vault_id}/ # Medienpipeline-Storage
media/
images/{slug}.webp
videos/{slug}/index.m3u8
documents/{filename}
thumbnails/
images/{slug}_thumb.webp
videos/{slug}_thumb.webpRate Limiting
Drei Stufen nach Ressourcenintensität:
| Stufe | Limit | Endpoints |
|---|---|---|
| Default | 60 RPM | Die meisten API-Endpoints |
| Upload | 15 RPM | Datei-Upload, Transcoding |
| Serving | 300 RPM | Medienauslieferung, Thumbnails |
REST ist die Vertragsfläche
Die REST-API ist der stabile, versionierte Weg, die Plattform aus jeder Sprache oder Integration anzusteuern. Der Workspace-MCP-Server ist ein dünner Agenten-Adapter, der direkt auf dieselben Operationen abbildet — keine Parallelimplementierung, kein Drift. Was ein Studio kann, kann die API; was die API kann, kann ein Agent über MCP.
Eigenen Agenten mitbringen
Externe Agenten — Claude Desktop, ein eigener Loop oder alles, was MCP spricht — verbinden sich mit einem Workspace und betreiben ihn direkt: Dateien lesen und schreiben, Prozesse steuern und überwachen, Medien verwalten, Output veröffentlichen. Der Agent arbeitet gegen dieselben Operationen mit Governance wie Menschen, begrenzt auf einen Account und dessen Dateien, mit dem Memory-Graph als Kontext.
Drei Schritte zu Ihrem ersten Workspace.
Läuft auf Ihrer Infrastruktur
Als einzelnes Docker-Image ausliefern. Einen privaten Authoring-Node plus beliebig viele öffentliche Delivery-Nodes betreiben, föderiert über einen Code-Pfad und synchron gehalten. Jeder Account ist eine DB-pro-Account-Grenze — Datenresidenz und Souveränität sind Standard, kein Zusatz.
Mit dem Aufbau beginnen
Architektur erkunden, Agenten über MCP anbinden und einen eigenen Workspace betreiben.