﻿---
title: iNNfo â€” the iNNfo modeling hub
description: iNNfo is the hub for the iNNfo ecosystem. Model, edit, and validate iNNfo knowledge models with the iNNfo Modeler, the innfo-core library, and an MCP server for AI agents.
html_url: https://innfo.cognitive.com/
generator: https://skills.innv0.com/innv0-web-design-guide
---

# iNNfo â€” the iNNfo modeling hub

Model, edit, and validate iNNfo knowledge models. iNNfo is the hub for the iNNfo ecosystem.

## What is iNNfo?

A monorepo that ties the iNNfo ecosystem together:

- **iNNfo Modeler** (`innfo-editor`) â€” a Vue 3 workspace editor. Open any folder, parse it into one normalized model tree, edit nodes, and validate in the browser.
- **@cognnitive/innfo-core** â€” the shared TypeScript parser, spec-chain resolver, and validator.
- **@cognnitive/innfo-mcp** â€” an MCP server exposing iNNfo as semantic tools for AI agents.
- **Spec Chain** â€” defiNNe &rarr; iNNfo &rarr; Templates &rarr; Models.

## How the iNNfo Modeler works

1. **Open workspace** â€” pick a folder via the File System Access API (or resume a recent one).
2. **Single parse pass** â€” one recursive pass walks the workspace; each `_NN.md` file and its structural children fold into a single normalized tree.
3. **Edit & validate** â€” sidebar tree + block sheets / table view + automatic validation against the iNNfo spec on every parse.

## Ecosystem Architecture

- **Level 0: defiNNe** â€” meta-specification, RFC 2119, versioning.
- **Level 1: iNNfo** â€” the central spec; single-file `_NN.md` models with YAML frontmatter.
- **Level 2: Templates** â€” business, procedures, organization.
- **Level 3: Models** â€” concrete data instances.

## Built for AI agents

- **innfo-mcp** â€” a stdio MCP server with seven semantic tools (`list_models`, `read_model`, `get_spec`, `get_template`, `validate_model`, `apply_change`, `validate_model_url`) so agents mutate models safely and re-validate every step.
- **traNNsform** â€” Import/Export panels generate a ready-to-run agent prompt. Drop sources into `traNNsform/input/` to build iNNfo models, or export a model to a self-contained HTML visualizer in `traNNsform/output/`.
- **Use iNNfo with AI** â€” a built-in checklist to connect your workspace to Claude Code, Google Antigravity, or OpenCode.

## Open Knowledge Format compatibility

iNNfo is **100% compatible** with [OKF v0.1](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) (Open Knowledge Format). Every iNNfo document is a valid OKF knowledge bundle:

- **Shared substrate**: Markdown + YAML frontmatter â€” no proprietary tooling required.
- **Conformance**: OKF's three conformance requirements (parseable frontmatter, non-empty `type`, reserved filenames) are all met by iNNfo. The `level` and template system provide type semantics; `index.md` follows the same progressive-disclosure convention.
- **Extensions tolerated**: OKF explicitly tolerates unknown frontmatter keys and `type` values. iNNfo's richer frontmatter (`spec_version`, `level`, `parent`, `concepts`, `markers`, `matrices`) is fully compatible.
- **A workspace = an OKF Bundle**: an iNNfo workspace is exactly the directory-of-Markdown-files structure OKF defines as its knowledge bundle. Each `_NN.md` is an OKF concept document.

## Monorepo structure

```
iNNfo/
â”œâ”€â”€ apps/
â”‚   â””â”€â”€ innfo-editor/     â† Vue 3 workspace editor (the iNNfo Modeler)
â”œâ”€â”€ packages/
â”‚   â”œâ”€â”€ innfo-core/       â† TS parser, resolver, validator
â”‚   â”œâ”€â”€ innfo-mcp/        â† MCP server for AI agents
â”‚   â””â”€â”€ pipeline-gates/   â† Validation & integration gates
â”œâ”€â”€ specs/                â† defiNNe, iNNfo, templates, samples
â”œâ”€â”€ traNNsform/           â† Agent-driven import/export pipeline
â””â”€â”€ docs/                 â† This website
```

[Launch App](https://innfo.cognitive.com/app/)
[About the project](https://innfo.cognitive.com/about)
[Documentation](https://innfo.cognitive.com/documentation)
