Kumiko ist ein Framework für Geschäfts-Apps in TypeScript. Ihr beschreibt Entitäten und Handler einmal, und Kumiko macht daraus Masken, eine API und Tools für euren KI-Assistenten. Jede Änderung wird als Event gespeichert, damit habt ihr den vollständigen Verlauf, Zeitreise und Rebuild. Eine App kann mehrere Kunden oder Firmen bedienen und ihre Daten sauber trennen (mandantenfähig), und einzelne Funktionen lassen sich pro Kunde ein- und ausschalten.
Was ihr bekommt
- Ein öffentliches GitHub-Repository unter github.com/CosmicDriftGameStudio/kumiko-framework mit dem vollständigen Quelltext, allen Tests und allen Beispielen
- Fertige Pakete auf NPM, dem Paketverzeichnis für JavaScript und TypeScript (
@cosmicdrift/kumiko-framework,@cosmicdrift/kumiko-bundled-features,@cosmicdrift/kumiko-dev-serverund weitere), frei nutzbar - Ein Kommandozeilen-Werkzeug zum Entwickeln, Testen, Bauen und für Datenbank-Updates (
bun kumiko dev | test | build | migrate) - Die MIT-Lizenz: frei nutzbar für jeden Zweck, auch kommerziell und als Hosting für Dritte
Was ihr selbst übernehmt
- Hosting, also den Betrieb auf euren eigenen Servern oder bei einem Cloud-Anbieter (etwa mit Docker auf Coolify, Hetzner, Kubernetes oder eigener Hardware)
- Die Pflege eures Codes und eures Event-Verlaufs
- Die Anbindung der KI mit eurem eigenen Zugang (BYOK, „bring your own key”): Anthropic, OpenAI oder ein lokales Modell über Ollama
Für wen das gedacht ist
- Entwickler-Teams, die volle Kontrolle wollen und ihr Hosting selbst beherrschen
- Mittelständler im DACH-Raum mit eigener IT, die Software im eigenen Haus betreiben
- Software-Häuser, die für mehrere Kundenprojekte denselben technischen Unterbau nutzen wollen
Woraus Kumiko gebaut ist
| Schicht | Technik | Wofür |
|---|---|---|
| Laufzeit | Bun | führt den Code aus |
| API | Hono | Schnittstelle, über die Apps und Dienste mit dem Server sprechen |
| Datenbank | Postgres + Drizzle ORM | speichert alle Daten; Drizzle übersetzt zwischen Code und Datenbank |
| Login | jose (JWT) | Anmelde-Token, die belegen, wer eingeloggt ist |
| Validierung | Zod | prüft Eingaben, bevor sie gespeichert werden |
| Suche | Meilisearch (über eine austauschbare Schnittstelle) | Volltextsuche über eure Daten |
| Oberfläche | React + Expo | Web plus installierbare PWA |
| Echtzeit | SSE über Redis Pub/Sub | Änderungen erscheinen ohne Neuladen live auf dem Bildschirm |
| Tests | bun:test | automatische Tests, in Bun eingebaut |
Postgres speichert jede Änderung als Ereignis, erzeugt daraus die Ansichten für die Oberfläche und gilt als einzige Quelle der Wahrheit. Deshalb braucht es weder Kafka noch EventStoreDB oder NATS (andere Systeme für Ereignisströme). Weniger Bausteine bedeuten weniger Aufwand im Betrieb.
Fertige Bausteine (optional)
Sie liegen alle im Paket @cosmicdrift/kumiko-bundled-features:
auth-email-password: Anmeldung mit E-Mail und Passwort, Passwort zurücksetzen, E-Mail bestätigensessions: Sitzungen verwalten und bei Bedarf sofort beenden, alte Sitzungen aufräumentenantunduser: Stammdaten der Kunden (Mandanten) und ihrer Nutzerdeliverymitchannel-in-app,channel-emailundchannel-push: Benachrichtigungen in der App, per E-Mail und als Push-Nachrichttemplate-resolverunddocument-designer: Mail- und PDF-Vorlagen in der Datenbank, im Browser bearbeitet, mit Vorschau und Test-Mailjobs: Aufgaben im Hintergrund abarbeiten (auf Basis von BullMQ)feature-toggles: technische Schalter pro Kundeaudit: automatischer Änderungsverlaufsecrets: verschlüsselter Speicher für Zugangsdatenfiles-provider-s3: Dateiablage in S3-kompatiblem Speicher wie MinIO
Alle sind optional. Ein einfaches Hello World kommt ohne sie aus.
Beziehung zur Plattform
kumiko.rocks läuft selbst auf dem Framework. Was neu ins Framework kommt, steht damit automatisch auch auf der Plattform bereit, umgekehrt nicht. Funktionen, die nur zur Plattform gehören, also der Designer, der KI-Builder (Enterprise), das Einrichten neuer Kunden-Umgebungen und die Abrechnung, liegen in einem privaten Repository und sind nicht Teil der Open-Source-Veröffentlichung. Die Plattform selbst betreiben könnt ihr zu Enterprise-Konditionen.
Mehr dazu unter die gehostete Plattform.
Nächster Schritt
- Repo erkunden: github.com/CosmicDriftGameStudio/kumiko-framework
- Docs und Tutorial: docs.kumiko.rocks
Weiter in der Doku (englisch)