Show HN: Kiso, an open-source publishing engine for Open Knowledge Format

straumat1 pts0 comments

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

Demo<br>Download

Open Knowledge Format

Publishing engine for Open Knowledge Format

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

View an example<br>Download<br>CLI

Build a site

kiso-cli build \<br>"> --source=examples/kb-google-example \<br>"> --destination=public

The generated directory can be opened locally or published on any HTTP server.

The result with the Google examples can be seen here.

First principle

OKF is the source of truth.

Structured Markdown

Knowledge remains easy to edit, review, diff, and<br>version in Git.

Explicit metadata

Pages keep enough context to be validated, linked,<br>and rendered consistently.

Agent friendly

Generated HTML keeps clear links back to the original<br>Markdown files.

Command

What build does

The build command generates a static<br>website from an OKF bundle, including the original Markdown files, generated HTML pages,<br>llms.txt, and sitemap.xml.

source<br>Any OKF bundle directory like examples/kb-google-example

destination<br>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<br>Pages or any other static hosting service.

- name: Build with Kiso<br>uses: oak-invest/kiso/applications/kiso-cli-action@v0.1.2<br>with:<br>command: build<br>source: examples/kb-google-example<br>destination: website/examples/kb-google-example-latest

01

Browse

Readers get a structured static website with navigation<br>and readable pages.

02

Inspect

Each page can link back to its Markdown source for review<br>and reuse.

03

Publish

The result is plain static output that can be hosted<br>locally or over HTTP.

Try Kiso on the Google Analytics sample knowledge<br>base.

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

View our example

kiso knowledge example build open source

Related Articles