https://github.com/supernovae-st/novanet
🪽 NovaNet — Native content generation engine powered by Neo4j knowledge graphs (Turborepo monorepo)
https://github.com/supernovae-st/novanet
ai content-generation knowledge-graph localization mcp neo4j nextjs ratatui rust tui turborepo typescript
Last synced: 3 months ago
JSON representation
🪽 NovaNet — Native content generation engine powered by Neo4j knowledge graphs (Turborepo monorepo)
- Host: GitHub
- URL: https://github.com/supernovae-st/novanet
- Owner: supernovae-st
- License: other
- Created: 2026-01-26T15:04:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-30T17:04:22.000Z (3 months ago)
- Last Synced: 2026-03-30T19:07:36.015Z (3 months ago)
- Topics: ai, content-generation, knowledge-graph, localization, mcp, neo4j, nextjs, ratatui, rust, tui, turborepo, typescript
- Language: Cypher
- Homepage: https://qrcode-ai.com
- Size: 1.21 GB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG-LATEST.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# 🪽 NovaNet
**Native content generation engine powered by Neo4j knowledge graphs**
> **Status: Active Development** — NovaNet is the knowledge layer of the [SuperNovae](https://github.com/supernovae-st) ecosystem. Currently in stabilization while [Nika](https://github.com/supernovae-st/nika) (the runtime) prepares for its open source launch. v0.21.0 stable, 2,215 tests passing.
Generate culturally-native content across 200+ locales — not translation, but true localization from semantic concepts.
[](https://github.com/supernovae-st/novanet/actions)
[](https://github.com/supernovae-st/novanet)
[](https://rust-lang.org)
[](https://typescriptlang.org)
[](https://neo4j.com)
[](https://turbo.build)
[](https://pnpm.io)
[](https://nodejs.org)
---
> **Generation, NOT Translation**
>
> ```
> Source → Translate → Target ❌ Traditional
> Entity (defined) → Generate natively → EntityNative ✅ NovaNet
> ```
>
> Content 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.
---
## Features
| | | | |
|:---:|:---:|:---:|:---:|
| **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 |
---
## Architecture
```mermaid
%%{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
```
---
## Quick Start
**Prerequisites**
```bash
# 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 dev
```
Open [http://localhost:3000](http://localhost:3000) — Neo4j Browser at [http://localhost:7474](http://localhost:7474)
---
## Monorepo Structure
```
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
```
---
## Packages
| 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) |
---
## Commands
### Development
| 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 |
### Infrastructure
| 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) |
### Rust CLI (tools/novanet)
```bash
# 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 UI
```
### Turborepo Filters
```bash
pnpm build --filter=@novanet/core # Build only core
pnpm test --filter=@novanet/studio # Test only studio
pnpm build --filter=...[HEAD^1] # Build changed packages
```
---
## Neo4j Access
```
Browser: http://localhost:7474
Bolt: bolt://localhost:7687
User: neo4j
Password: (see NEO4J_PASSWORD env var)
```
---
## Graph Schema
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`](packages/core/models/taxonomy.yaml) for complete schema.
---
## TUI (Terminal UI)
**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** — `z` maximizes 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
---
## MCP Server (AI Agent Integration)
**7 tools** for AI agents to interact with the knowledge graph via [Model Context Protocol](https://modelcontextprotocol.io):
| 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 |
---
## Studio Features
**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, 0` keys
- **AI Chat** — Natural language to Cypher with `⌘J`
- **40+ Keyboard Shortcuts** — Full keyboard navigation
- **DX-First** — Every property is copyable (JSON/TS/YAML)
---
## Tech Stack
**Runtime**
**Data**
**Tools**
---
## Environment Variables
Copy `.env.example` to `.env.local` in `apps/studio/`:
```bash
# Required
NEO4J_PASSWORD=novanetpassword
# Optional (for AI features)
ANTHROPIC_API_KEY=sk-ant-xxx
```
---
## Target Application
NovaNet powers **[QR Code AI](https://qrcode-ai.com)** — generating native content across 200+ locales for the world's most advanced QR code platform.
---
## License
This project is **proprietary software** owned by [SuperNovae Studio](https://github.com/supernovae-st). All rights reserved.
---
**[SuperNovae Studio](https://github.com/supernovae-st)**