Kumiko ist ein Framework, also ein Baukasten für Software. Damit baut ihr Geschäfts-Apps in der Programmiersprache TypeScript, die mehrere Kunden oder Firmen in einer App bedienen und deren Daten sauber trennen (das heißt mandantenfähig). Jede Änderung an den Daten wird automatisch in einem Änderungsprotokoll festgehalten, 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 Lizenz BSL-1.1: frei nutzbar für alles außer kommerzielles Hosting, das mit kumiko.rocks konkurriert. Nach 2 Jahren wird jede Version automatisch zu Apache-2.0, einer vollständig offenen Lizenz. Solange wir aktiv weiterentwickeln, ist der jeweils aktuelle Stand also 2 Jahre geschützt. Ältere Versionen gehören der Community
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 des Repositorys mit eurem Code und eurem Änderungsprotokoll
- 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 müssen
- 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 | eine Codebasis für Web und Mobile |
| 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-Nachrichtjobs: Aufgaben im Hintergrund abarbeiten (auf Basis von BullMQ)feature-toggles: technische Schalter pro Kundeaudit: automatisches Änderungsprotokollsecrets: 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, 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 zu betreiben ist nur zu Enterprise-Konditionen möglich.
Mehr dazu unter die gehostete Plattform.
Nächster Schritt
- Repo erkunden: github.com/CosmicDriftGameStudio/kumiko-framework (Public-Launch in Vorbereitung)
- Pilot-Programm für den DACH-Mittelstand: mehr dazu auf der Startseite