KnowledgeSDK

🚧

Coming Soon — Das KnowledgeSDK befindet sich in aktiver Entwicklung. Die API ist stabil und wird bereits produktiv auf dieser Seite (docs.processcube.io) eingesetzt. Die NPM-Pakete, Docker-Images und die Single-Binary werden in Kuerze ueber den ProcessCube Marketplace veroeffentlicht.

Hybrid-Suche (BM25 + Vektor) als wiederverwendbares SDK fuer beliebige Dokumentationen und Knowledge Bases.

Was ist KnowledgeSDK?

@processcube-io/knowledge-sdk extrahiert die bewaehrte Suche von docs.processcube.io in zwei NPM-Pakete:

@processcube-io/knowledge-sdk — Core-SDK: Indexer, Store, Adapter, MCP, Auth
@processcube-io/knowledge-sdk-ui — Konfigurierbare React-Suchkomponente

Features

BM25-Volltextsuche ueber SQLite (FTS5) — schnell, ohne externe Services
Hybrid-Suche mit Vektor-Embeddings (OpenAI, Voyage AI) + Reranking
Plugin-System fuer Content-Sources (Built-in: Dateisystem, GitHub)
Framework-Adapter fuer Next.js, Express, Hono oder als Standalone-Server
MCP-Server fuer AI-Assistenten (search_docs, list_collections, classify_ticket)
Ticket-Classifier — ordnet Support-Tickets der passenden Collection + Repo zu (mit Self-Improvement)
Auth-Plugins (API-Key, Odoo mit Cache)
React UI — Such-Dialog mit Cmd+K, Collection-Filter, Keyboard-Navigation
Docker-Images fuer Standalone-Betrieb
Single-Binary (Bun) fuer lokale Installation ohne Node.js

Architektur


@processcube-io/knowledge-sdk
  core/        — Store, Types, Embedding-Adapter, Limiter, Result-Formatter
  indexer/     — Plugin-Registry, generischer Indexer
  plugins/     — Filesystem-Source, GitHub-Source (built-in)
  adapters/    — Next.js, Express, Hono, Standalone HTTP-Server
  auth/        — Env-Auth (API-Key), Odoo-Auth (REST + Cache)
  classifier/  — Ticket-Classifier (Scoring, LLM, Feedback-Store)
  mcp/         — Generischer MCP-Server
  cli/         — Entrypoints fuer Docker + Single-Binary

@processcube-io/knowledge-sdk-ui
  SearchDialog — Konfigurierbare React-Komponente

Einsatzszenarien

Szenario	Loesung
Next.js-App mit Suche	SDK als Dependency + Framework-Adapter
Express/Hono-Backend	SDK Middleware
Eigenstaendiger Such-Service	Docker-Image (REST + MCP)
Lokale Nutzung	Single-Binary (`knowledge-sdk serve`)
BPMN-Prozess mit Suche	REST-API des Standalone-Servers
AI-Assistent	MCP-Endpoint
Ticket-Klassifikation	Classifier als Library oder REST-API
External Task mit Klassifikation	Library-Nutzung