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

> Source: <https://oak-invest.github.io/kiso/>
> Published: 2026-06-27 21:08:03+00:00

# Publishing engine for Open Knowledge Format

Kiso is a publishing engine that turns [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) (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
```

### Browse

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

### Inspect

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

### 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.