From Spec Doc or BPMN to Governed Architecture

Upload a spec doc or a BPMN process. K9X Studio reads it and lays out a governed K9-AIF architecture on the canvas — Router, Orchestrators, Squads, and Agents, wired together with governance built in from the start.

1Setup LLM
2Upload Spec Doc
or BPMN
3Canvas
Auto-Generates
4Generate
Scaffold
K9X Studio canvas — Router, Orchestrators, Squads, and Agents laid out automatically from an uploaded spec or BPMN
K9X Studio Canvas — a real architecture, laid out automatically.
Spec Doc → ArchitectureUpload a markdown spec — the canvas auto-generates Router, Orchestrators, Squads, and Agents.
BPMN → ArchitectureImport from Blueworks, Camunda, or Bizagi — your process flow becomes a governed architecture.
Visual CanvasDrag-and-drop K9-AIF components and wire them into a flow.
TemplatesStart from Insurance, Finance, Healthcare, or Customer Service baselines.
Scaffold, Not ShortcutsGenerates SBBs wired to K9-AIF's ABB contracts — a real project structure, ready for your logic.
Try it hosted Open K9X Studio →
Run it locally
$ pip install k9x && k9x studio

Start With the Right Architecture. Build Your Logic In.

k9aif inspect ensures it never drifts.

Generate Scaffold doesn't hand you a black box — it hands you a real Python project, structured exactly like the architecture you designed. Every Router, Orchestrator, Squad, and Agent is a Solution Building Block (SBB), wired to its K9-AIF Architecture Building Block (ABB) contract. You write the business logic. k9aif inspect checks that what you built still matches what you designed — every time you run it, not just on day one.

1 Generate Scaffold Studio exports SBBs — real classes, real files, wired to ABB contracts.
2 Implement Business Logic You write the logic that makes each agent do its job.
3 k9aif inspect Validates every SBB against its ABB contract. Drift is caught, not shipped.

A Real Project Structure — Not a Black Box

Generate Scaffold hands you an actual Python project: one folder per Router, Orchestrator, Squad, and Agent, each a Solution Building Block already wired to its K9-AIF Architecture Building Block contract.

Open it in your editor and the architecture you designed on the canvas is right there — in the folder tree, the class names, the imports. You write the business logic; the structure is already correct.

Generated K9-AIF scaffold — folder structure with SBBs wired to ABB contracts
Generated scaffold — SBBs ready for your logic.
Generated SBB class extending its K9-AIF ABB base class
Each SBB extends its K9-AIF ABB — architecture by construction.

The Class Diagram Is the Compliance Report

"The entire history of software engineering is one of rising levels of abstraction. This is as it was, is now, and always shall be." — Grady Booch

K9-AIF's ABB classes are that next layer of abstraction for agentic systems. Every generated SBB extends an ABB base class — the inheritance itself is the contract. Look at the class diagram and you're looking at the compliance report: governance, validation loops, and message-bus wiring are inherited, not hand-rolled per agent.

That base layer also carries proven design patterns — critic-actor loops, validation loops, planning loops, and more. patterns.k9x.ai catalogs them, and why each one earns its place in the framework.

The K9-AIF Framework, as a Graph

Not your SBB — the framework it's built on. Every ABB your scaffold extends lives here, mapped in full.

K9-AIF Framework Map — every layer, dependency, and relationship Explore live at graph.k9x.ai →

Every layer. Every dependency. Every relationship.
Governed architecture — not scripted agents.

Get Running in Minutes

No LLM needed to start. Full pipeline runs with mock provider — or launch the visual Studio with one command.

k9aif framework
$ pip install k9-aif
Successfully installed k9-aif
$ k9aif init
Scaffolding K9-AIF project structure...
$ python main.py
Squad initialized. Agents registered. Pipeline running.
$ k9aif doctor
✓ All checks passed
$ k9aif --help
Usage: k9aif [OPTIONS] COMMAND [ARGS]...
k9x studio
$ pip install k9x
Successfully installed k9x
$ k9x studio
[k9x] Listening on localhost:12999
[k9x] URL: http://localhost:12999
✓ Ready to rumble!
$ k9x config
Wrote ./.env-example
$ k9x --help container
Usage: k9x [-h] {help,studio,config} ...
# Found a bug? k9x.atlassian.net
Framework that is customizable.
Studio that builds using the Framework.

Architecture Hierarchy

A deliberate, layered execution model — every component has a defined role.

Event
Entry point
Router
Routes by intent
Orchestrator
Coordinates domain
Squad
Executes flow
Agent
Implements execute()
LLM
Governed inference
Governance Model Router Zero Trust Security Observability Persistence Messaging Inference

Each layer knows only the layer to its right. Never two steps ahead. Never back.

Applying architecture principles, patterns, and governance to the design and execution of agentic process flows and integrations.

Web Apps
APIs
CrewAI
LangChain
IBM Watsonx
BPMN / Blueworks
External Agents
K9-AIF ARCHITECTURE BUS
EVENT DRIVEN  ·  GOVERNED  ·  OBSERVABLE  ·  SECURE
Router
Orchestrator
Squad
Agent
Governance
Zero Trust
Model Router
Inference
Observability
Persistence
Messaging
Graph
Storage
Security

Framework Principles

Architecture First

Design the system before writing code. ABBs define contracts. SBBs implement them.

Governed Execution

Every agent boundary enforces governance. Policy-checked before action executes.

ABB / SBB Separation

Stable abstract contracts. Swappable concrete implementations. Eclipse-style extension points.

Zero Trust Execution

Every agent action verified and risk-evaluated prior to execution at the architecture layer.

Pluggable Providers

Ollama, Watsonx, OpenAI — swap via config. No code changes required.

Observable by Default

Every routing decision persisted. Full audit trail without extra instrumentation.

Enterprise Integration

Kafka, PostgreSQL, Neo4j, MCP. Production infrastructure, not demo infrastructure.

Vendor Neutral

No lock-in. LLM provider, messaging, persistence — all configurable, all replaceable.

The 2 A.M. Problem

It's 2 a.m., and an autonomous agent just approved a $40,000 reimbursement that should have been flagged for review.

Nobody wrote bad code. The agent did exactly what its prompt told it to do. The orchestration framework executed every step, on schedule. The demo worked great in front of the VP three weeks ago.

But there was no architecture between "agent decided" and "agent acted." No governed boundary checking the decision against policy before it executed. No audit trail explaining why. No contract defining what this agent was — and wasn't — allowed to do. Just a system prompt, a framework, and trust.

K9-AIF doesn't make your agents smarter. It makes the system around them accountable.

CLI Experience

K9-AIF ships with a full command-line interface. Verify, inspect, generate, and run — from the terminal.

k9aif

Ready to build in VS Code + Claude Code

K9-AIF is available as an installable Python package. Open a terminal, install the library, run k9aif init and start building governed multi-agent systems — right inside your IDE.

pip install k9-aif k9aif init python main.py

Where K9-AIF Fits

K9-AIF defines how the full agentic AI system is architected.

  • Frameworks like CrewAI define how agents collaborate
  • Cloud platforms like Azure and AWS provide infrastructure
  • Runtimes execute workflows

"I Already Use CrewAI. Why K9-AIF?"

Because they're not solving the same problem.

CrewAI — and LangChain, and Watsonx Orchestrate — answer how agents collaborate: task delegation, tool calls, message passing. They're execution frameworks, and good ones.

K9-AIF answers a different question: what is this system, architecturally, and how do we know it's still that system tomorrow? Routers, Orchestrators, Squads, and Agents are ABBs with defined contracts. Governance, Zero Trust checks, and audit trails are wired in at the architecture layer — not bolted onto whichever framework happens to execute the work underneath.

K9-AIF — Architecture, Governance, Contracts (ABB / SBB)
governs ↓
CrewAI · LangChain · Watsonx Orchestrate — Execution

K9-AIF doesn't replace your execution framework. It governs it.

About K9-AIF

K9-AIF did not begin as a grand architectural vision. It began as a retrieval capability — and evolved into an architecture-first framework for governed agentic AI systems.

Read how K9-AIF started →

The architecture that outlasts the technology →

Ravi Natarajan
AI Systems Architect — Agentic AI · Multi-Agent Systems · Enterprise Architecture

Your agents deserve an architecture.
K9-AIF gives them one.

Open K9X Studio →
$ pip install k9-aif