KnowledgeOS — Knowledge Operating System

Architecture

Layered by Design

Every layer has a single responsibility. Dependencies flow in one direction.

Layer 0

Kernel

Foundation components: EventBus, Error Hierarchy, Config, Logger, Context, Plugin Registry, Timer, Validation.

8 components 169 tests

Layer 1

Subsystems

Persistence, Graph, Search & Indexing, Plugin System. Each depends only on the Kernel.

4 subsystems 333 tests

Layer 2

Public API

Contract Layer with 27 operations, 29 error codes, 8 lifecycle events, and contract-based validation.

13 modules 167 tests

Layer 3

SDK

Thin TypeScript binding with fluent API, version negotiation, discovery, and pagination.

13 modules 125 tests

Quick Start

Try KnowledgeOS

Clone the repository, install dependencies, and run the demo.

terminal

# Clone and build
git clone https://github.com/aymanelmasryael/KnowledgeOS.git
cd KnowledgeOS
npm install
npm run build

# Run the quickstart demo
npm start

Getting Started Guide Quickstart Source All Examples

app.ts — SDK usage example

import { KnowledgeClient } from "@knowledgeos/sdk";

// Build the client
const client = KnowledgeClient.builder()
  .endpoint("https://api.knowledgeos.dev")
  .tokenAuth("your-api-token")
  .fixedVersion("v1")
  .build();

// Knowledge operations
const result = await client.knowledge().get("object-id");

// Graph operations
const node = await client.graph().getNode("node-id");

// Search
const results = await client.search().search({
  query: "your search query",
  graphId: "graph-id",
});

// Discover the platform
const platform = await client.discovery().describe();
console.log(platform.operations);

Note: @knowledgeos/sdk is not yet published to npm. The SDK code above requires cloning the repository and using workspace references. See the SDK example for a fully runnable version.

Resources