{"slug": "show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format", "title": "Show HN: Kiso, an open-source publishing engine for Open Knowledge Format", "summary": "Oak Investment released Kiso, an open-source publishing engine that converts Open Knowledge Format bundles into static websites for both human readers and AI agents. The tool generates HTML pages, llms.txt, and sitemap.xml from structured Markdown files, and includes a GitHub Action for automated deployment.", "body_md": "# Publishing engine for Open Knowledge Format\n\nKiso is a publishing engine that turns [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) (OKF)\nbundles into static websites for humans and AI agents.\n\nFirst principle\n\n## OKF is the source of truth.\n\n### Structured Markdown\n\nKnowledge remains easy to edit, review, diff, and version in Git.\n\n### Explicit metadata\n\nPages keep enough context to be validated, linked, and rendered consistently.\n\n### Agent friendly\n\nGenerated HTML keeps clear links back to the original Markdown files.\n\nCommand\n\n## What build does\n\nThe `build`\n\ncommand generates a static\nwebsite from an OKF bundle, including the original Markdown files, generated HTML pages,\nllms.txt, and sitemap.xml.\n\n| source | Any OKF bundle directory like `examples/kb-google-example` |\n|---|---|\n| destination | `public` or any static directory |\n\nGitHub Action\n\n## Use in Github CI\n\nYou can use Kiso in a GitHub Action to automatically build and publish your OKF bundle to GitHub Pages or any other static hosting service.\n\n```\n - name: Build with Kiso\n   uses: oak-invest/kiso/applications/kiso-cli-action@v0.1.2\n   with:\n    command: build\n    source: examples/kb-google-example\n    destination: website/examples/kb-google-example-latest\n```\n\n### Browse\n\nReaders get a structured static website with navigation and readable pages.\n\n### Inspect\n\nEach page can link back to its Markdown source for review and reuse.\n\n### Publish\n\nThe result is plain static output that can be hosted locally or over HTTP.\n\n## Try Kiso on the Google Analytics sample knowledge base.\n\nThe example shows how an OKF bundle becomes a navigable site for Humans and AI agents.", "url": "https://wpnews.pro/news/show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format", "canonical_source": "https://oak-invest.github.io/kiso/", "published_at": "2026-06-27 21:08:03+00:00", "updated_at": "2026-06-27 21:34:40.280178+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "generative-ai"], "entities": ["Oak Investment", "Kiso", "Open Knowledge Format", "GitHub", "Google Cloud Platform"], "alternates": {"html": "https://wpnews.pro/news/show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format", "markdown": "https://wpnews.pro/news/show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format.md", "text": "https://wpnews.pro/news/show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format.txt", "jsonld": "https://wpnews.pro/news/show-hn-kiso-an-open-source-publishing-engine-for-open-knowledge-format.jsonld"}}