Kiso, a publishing engine for Open Knowledge Format (OKF).e

Open Knowledge Format Kiso is a publishing engine that turns Open Knowledge Format (OKF) bundles into static websites for humans and AI agents.

First principle OKF is the source of truth. Structured Markdown Knowledge remains easy to edit, review, diff, and version in Git. Explicit metadata Pages keep enough context to be validated, linked, and rendered consistently. Agent friendly Generated HTML keeps clear links back to the original Markdown files.

Command What build does The build command generates a static website from an OKF bundle, including the original Markdown files, generated HTML pages, llms.txt, and sitemap.xml. source Any OKF bundle directory like examples/kb-google-example destination public or any static directory

GitHub Action Use in Github CI You can use Kiso in a GitHub Action to automatically build and publish your OKF bundle to GitHub Pages or any other static hosting service. - name: Build with Kiso uses: oak-invest/kiso/applications/kiso-cli-action@v0.1.2 with: command: build source: examples/kb-google-example destination: website/examples/kb-google-example-latest

01 Browse Readers get a structured static website with navigation and readable pages. 02 Inspect Each page can link back to its Markdown source for review and reuse. 03 Publish The result is plain static output that can be hosted locally or over HTTP.

Try Kiso on the Google Analytics sample knowledge base.

The example shows how an OKF bundle becomes a navigable site for Humans and AI agents.