Native content generation engine powered by Neo4j knowledge graphs
Generate culturally-native content across 200+ locales — not translation, but true localization from semantic concepts.
Generation, NOT Translation
Source → Translate → Target ❌ Traditional Entity (defined) → Generate natively → EntityNative ✅ NovaNetContent is generated natively per locale from defined semantic entities, not translated from a source language. Each locale gets culturally-native content, preserving local nuances that translation would lose.
| Knowledge Graph | 200+ Locales | Graph Studio | AI-Powered |
| 47 node types, 153 arcs | Native generation per locale | Interactive 2D visualization | Claude API for natural language queries |
| Neo4j with APOC | Locale knowledge layer | React Flow + ELK.js layouts | Cypher generation from text |
%%{init: {'theme': 'base', 'themeVariables': {
'primaryColor': '#6366f1',
'primaryTextColor': '#fff',
'primaryBorderColor': '#4f46e5',
'lineColor': '#94a3b8',
'secondaryColor': '#06b6d4',
'tertiaryColor': '#f8fafc'
}}}%%
flowchart TB
subgraph MONO["NovaNet Monorepo"]
direction TB
CORE["@novanet/core v0.24.0\nTypes · Schemas · Filters"]
DB["@novanet/db v0.24.0\nDocker · Seeds · Migrations"]
STUDIO["@novanet/studio v0.24.0\nNext.js 16 · React 19"]
RUST["novanet CLI v0.24.0\nRust · 30 commands · TUI"]
end
CORE --> STUDIO
RUST -.->|reads YAML| CORE
RUST -.->|generates| DB
NEO4J[("Neo4j 5.26\n~120,000 nodes")]
DB -.-> NEO4J
STUDIO --> NEO4J
RUST --> NEO4J
style CORE fill:#06b6d4,stroke:#0891b2,color:#fff
style DB fill:#10b981,stroke:#059669,color:#fff
style STUDIO fill:#8b5cf6,stroke:#7c3aed,color:#fff
style RUST fill:#DEA584,stroke:#B7410E,color:#fff
style NEO4J fill:#018bff,stroke:#0284c7,color:#fff
Prerequisites
# 1. Clone the repository
git clone git@github.com:supernovae-st/supernovae-agi.git
cd supernovae-agi/novanet
# 2. Install dependencies
pnpm install
# 3. Start Neo4j
pnpm infra:up
# 4. Seed the database
pnpm infra:seed
# 5. Start development server
pnpm devOpen http://localhost:3000 — Neo4j Browser at http://localhost:7474
novanet/
├── turbo.json # Turborepo pipeline config
├── pnpm-workspace.yaml # Workspace definitions
├── packages/
│ ├── core/ # @novanet/core — types, schemas, filters
│ │ ├── models/ # YAML schema definitions (source of truth)
│ │ │ ├── taxonomy.yaml # 2 realms (shared 4 + org 5), 9 layers
│ │ │ ├── node-classes/ # node definitions by realm/layer
│ │ │ └── arc-classes/ # arc definitions by family
│ │ ├── data/ # YAML data files (1,269 — single source of truth)
│ │ └── src/ # TypeScript implementation
│ └── db/ # @novanet/db — Neo4j infrastructure
│ ├── docker-compose.yml # Neo4j 5.26 + APOC
│ ├── seed/ # Cypher seed scripts
│ └── seed.sh # Seed runner
├── tools/
│ ├── novanet/ # Rust CLI + TUI binary
│ │ ├── src/ # Rust source (30 commands, 19 generators)
│ │ └── Cargo.toml # 2,215 tests passing, zero clippy warnings
│ └── novanet-mcp/ # MCP Server (7 tools)
└── apps/
└── studio/ # @novanet/studio — web visualization
├── src/app/ # Next.js App Router
├── src/components/ # React components
├── src/stores/ # Zustand state management
└── src/lib/ # Utilities
| Package | Version | Description |
|---|---|---|
| @novanet/core | 0.24.0 |
Types, Zod schemas, NovaNetFilter API, Cypher generators |
| @novanet/db | 0.24.0 |
Docker Compose for Neo4j, Cypher seeds, migrations |
| @novanet/studio | 0.24.0 |
Interactive graph visualization with AI chat |
| tools/novanet | 0.24.0 |
Rust CLI + TUI for schema generation, validation, queries |
| tools/novanet-mcp | 0.24.0 |
MCP Server for AI agent integration (7 tools) |
| Command | Description |
|---|---|
pnpm dev |
Start Studio dev server |
pnpm build |
Build all packages |
pnpm lint |
Lint all packages |
pnpm type-check |
TypeScript type checking |
pnpm test |
Run all tests |
| Command | Description |
|---|---|
pnpm infra:up |
Start Neo4j container |
pnpm infra:down |
Stop Neo4j container |
pnpm infra:seed |
Seed database with initial data |
pnpm infra:reset |
Reset database (down + up + seed) |
# Schema operations (YAML → Cypher/TS/Mermaid)
cargo run -- schema generate # Regenerate all artifacts
cargo run -- schema validate # Validate YAML coherence
# Navigation
cargo run -- blueprint # Schema-graph visualization
cargo run -- doctor # System health check
# Seed pipeline (YAML-first data management)
cargo run -- seed export # Parse Cypher seeds → YAML data files
cargo run -- seed generate-data # Generate Cypher from YAML data
cargo run -- seed validate # Validate YAML data files (CI gate)
cargo run -- seed diff # Compare YAML data with Neo4j
cargo run -- seed scaffold # Scaffold pages, blocks, instructions for entities
# Data management
cargo run -- data backup # Save Neo4j data to YAML
cargo run -- data status # Compare backup vs live
cargo run -- data promote # Promote runtime nodes to seed
cargo run -- data pull # Pull Neo4j native content to YAML data
# Interactive TUI
cargo run -- tui # Galaxy-themed terminal UIpnpm build --filter=@novanet/core # Build only core
pnpm test --filter=@novanet/studio # Test only studio
pnpm build --filter=...[HEAD^1] # Build changed packagesBrowser: http://localhost:7474
Bolt: bolt://localhost:7687
User: neo4j
Password: (see NEO4J_PASSWORD env var)
NovaNet models content as a knowledge graph with 2 Realms and 9 Layers (v0.24.0):
| Realm | Layers | Description |
|---|---|---|
| Shared | config, locale, geography, knowledge | Universal definitions + locale knowledge (READ-ONLY) — 33 nodes |
| Org | foundation, structure, semantic, instruction, output | Organization-specific content — 14 nodes |
Arcs are classified by 6 ArcFamilies: ownership, localization, semantic, generation, mining, schema.
See packages/core/models/taxonomy.yaml for complete schema.
NovaNet TUI is an interactive terminal explorer for the knowledge graph:
╭─ ● Data │ Org → Foundation → Entity (12) ──────────────────╮╭─ Identity ──────╮
│ ▶ Node Classes (47) │◉│ │ ◇ Entity │
│ ├─▶ ◉ Shared (33) │ │ │ realm: org │
│ │ ├─▶ ⚙ config (2) │◉│ │ layer: found. │
│ │ ├─▶ 🌐 locale (3) │ │ │ │
│ │ ├─▶ 🗺 geography (7) │◉│ │ ▰▰▰▰▰▰▰▰▱▱ 80%│
│ │ └─▶ 🧠 knowledge (21) │ │ ╰─────────────────╯
│ └─▶ ◎ Org (14) │◎│ ╭─ Properties ────╮
│ ├─▶ 🏛 foundation (6) │ │ │ key qr-code │
│ │ ├─ Entity (12) │ │ │ name QR Code │
│ │ │ > qr-code ···················· ▰▰▰▰▰▰▰▰▱▱ │ │ │ desc Quick... │
│ │ │ barcode ···················· ▰▰▰▰▰▰▱▱▱▱ │ │ │ slug qr-code │
│ │ │ nfc-tag ···················· ▰▰▰▱▱▱▱▱▱▱ │ │ ╰─────────────────╯
╰────────────────────────────────────────────────────────╯╰╯
Galaxy-themed terminal UI with 40+ keybindings, fuzzy search, and live Neo4j data
- Viewport culling — Only renders visible lines (O(1) per frame)
- 5 render caches — Zero-allocation idle frames
- Fuzzy search — nucleo-powered smart-case matching
- Panel zoom —
zmaximizes any panel to full screen - YAML preview — Syntax-highlighted schema definitions
- Atom tree — Browse knowledge atoms (Expression, Pattern, CultureRef) per class
- Keyword tree — SEOKeyword locale/intent grouping with load-more
7 tools for AI agents to interact with the knowledge graph via Model Context Protocol:
| Tool | Purpose |
|---|---|
novanet_describe |
Bootstrap — first contact with graph |
novanet_search |
Find nodes + graph walk (4 modes) |
novanet_introspect |
Schema info (classes, arcs) |
novanet_context |
LLM context assembly (page/block/knowledge) |
novanet_write |
Mutations (dry_run=true to validate first) |
novanet_audit |
Quality checks + CSR metrics |
novanet_batch |
Parallel operations |
NovaNet Studio is a web-based graph visualization tool:
┌─────────────────────────────────────────────────────────────────────────────┐
│ NovaNet Studio ⌘K ⌘J ? N F │
├─────────────────────────────────────────────────────────────────────────────┤
│ ┌─ Filters ──────┐ ┌─ Graph View ─────────────────────┐ ┌─ Details ────┐ │
│ │ Realm │ │ │ │ Page │ │
│ │ ☑ Shared │ │ [Locale]──┐ │ │ key: home │ │
│ │ ☑ Org │ │ │ ▼ │ │ realm: org │ │
│ │ │ │ [Project]──[Page]──[Block] │ │ layer: struc │ │
│ │ │ │ │ │ │ │ │ │
│ │ Layer │ │ ▼ ▼ │ │ Relations: │ │
│ │ ☑ Foundation │ │ [Entity]──[EntityNative] │ │ → 3 blocks │ │
│ │ ☑ Structure │ │ │ │ │ → 1 project │ │
│ │ ☑ Semantic │ │ ▼ │ │ │ │
│ │ ... │ │ [BlockNative] │ │ [Copy JSON] │ │
│ └────────────────┘ └──────────────────────────────────┘ └──────────────┘ │
├─────────────────────────────────────────────────────────────────────────────┤
│ Mode: Graph │ 47 nodes │ 153 arcs │ Zoom: 100% │ Locale: fr-FR │
└─────────────────────────────────────────────────────────────────────────────┘
Interactive 2D graph visualization with AI-powered queries (⌘J)
- Graph Mode — Unified tree exploration with
[1]key - 9 Filter Presets — Quick views via
1-8, 0keys - AI Chat — Natural language to Cypher with
⌘J - 40+ Keyboard Shortcuts — Full keyboard navigation
- DX-First — Every property is copyable (JSON/TS/YAML)
Runtime
Data
Tools
Copy .env.example to .env.local in apps/studio/:
# Required
NEO4J_PASSWORD=novanetpassword
# Optional (for AI features)
ANTHROPIC_API_KEY=sk-ant-xxxNovaNet powers QR Code AI — generating native content across 200+ locales for the world's most advanced QR code platform.
This project is proprietary software owned by SuperNovae Studio. All rights reserved.