openbkn-ai /bkn-foundry

BKN Foundry is the Ontology back-end foundation of OpenBKN. It transforms ontology-driven business semantics into runtime services: data, logic, actions, security governance, and observability.

★ 1,400⑂ 139👁 20⑃ 2,066● 1,182▤ 5
GoNOASSERTIONCreated 2026-05-26openbkn.ai
下载:v0.2.0v0.2.0 ↓0.2.02026-10-16
1,400
stars
139
forks
20
watchers
2,066
prs
1,182
issues
5
releases

README

BKN Foundry

中文 | English

🌐 Website: openbkn.ai

 






---




  


▶ Watch the full 3-minute OpenBKN video on YouTube



---

OpenBKN is an ontology-driven business knowledge network platform. Through ontology modeling, it turns the data and logic scattered across documents, systems, processes, rules, and expert experience into a business knowledge network that agents can understand, execute, and verify — so agents land accurately, safely, and reliably in real business environments, not just generating answers but continuously creating executable, traceable, and verifiable business value.

BKN Foundry is the technical foundation of OpenBKN, providing that business knowledge network with unified data access, safe execution, and governance.

On this page: 📚 Quick links · 🚀 Quick start · 🛠️ OpenBKN SDK · 🛡️ Administration · 🏗️ BKN Foundry · 📐 BKN Lang · 📊 Benchmarks

 Note: BKN Foundry is a backend-only framework — it does not include a web UI. All interactions are through the CLI, SDK, or API.



 📚 Quick Links

- 🛠️ OpenBKN SDK - End-user / agent BKN CLI, TypeScript SDK, and the AI agent skill
- 🤝 Contributing - Guidelines for contributing to the project
- 🚢 Deployment - One-click deploy to Kubernetes
- 📘 Documentation - Product documentation and usage guides (EN / 中文)
- 📖 API Reference - OpenAPI docs for every service (YAML source + rendered Markdown / interactive HTML)
- 📦 Samples - Runnable end-to-end walkthroughs, in their own repo
- 🧾 Release Notes - All notable changes



 🚀 Quick Start

1. Prerequisites & planning — read the Deployment Guide and satisfy its prerequisites. Linux is the supported target for full installs; macOS local dev (kind) is optional — see Mac install (dev) (中文).
2. Pre-install host check / fix with preflight.sh (recommended)

   On the target install host, run a system check before deploy.sh. It verifies kernel / sysctl / containerd / kubectl / helm / Node / BKN CLIs and can fix what's missing (each fix is opt-in unless -y):

bash
git clone https://github.com/openbkn-ai/openbkn-deploy.git
cd openbkn-deploy
chmod +x preflight.sh deploy.sh onboard.sh

sudo bash ./preflight.sh                 check-only (default)
sudo bash ./preflight.sh --fix           check + interactive fixes
sudo bash ./preflight.sh --fix -y        auto-approve every fix
sudo bash ./preflight.sh --list-fixes    preview which fixes would run, no changes
sudo bash ./preflight.sh --help          all flags (--role, --skip, --report, --output=json, …)


   Exit codes: 0 OK, 1 any FAIL, 2 only WARN. Use --report=/tmp/preflight.txt to keep a full log.

3. Run installation scripts:

bash
 (Same openbkn-deploy directory as step 2)

 Install the full BKN Foundry stack
./deploy.sh openbkn install

 Or specify addresses explicitly (skips interactive prompts):
   --access_address       Address for clients to reach OpenBKN services (can be IP or domain)
   --api_server_address   IP bound to a local network interface for K8s API server (must be a real NIC IP)
./

Top issues

Latest release

v0.2.0 v0.2.0 2026-10-16
BKN Foundry 0.2.0

Tag v0.2.0 · commit 81d5752

Versioned API documentation · Full changelog

 Highlights

- Row-level authorization and self-service access requests. Row filters apply across object reads, with fixed-condition predicates, policy management, permission guidance and permission-request workflows (1689, 1690, 1696, 1727, 1810, 1831, 1910, 1943).
- Compact MCP entry. /mcp-compact/ provides an on-demand gateway, including sandbox execution and schema information from the top search result. Schema and network summaries carry less repeated content (1756, 1776, 1801, 1812, 1849).
- Kaf

Snapshot: 2026-11-16T23:08:42Z · Data license Apache-2.0 · JSON