Skip to content
ย 
ย 

Latest commit

ย 

History

137 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŒ NodeScape v1.0.0

"Explore knowledge like a galaxy of interconnected ideas."

Status Tailwind CSS Three.js d3-force

NodeScape is an interactive AI-powered spatial knowledge graph explorer that combines visualization, note-taking, and idea exploration into a dynamic network of interconnected concepts, transforming concepts into a navigatable 3D/2D universe.


โœจ Features

๐Ÿก Graph Library

NodeScape includes a visual homepage that acts as a personal graph library.

Graphs are stored locally in your browser using local storage, making NodeScape an offline-first knowledge workspace.

You can:

  • create new knowledge graphs
  • rename or delete existing graphs
  • reopen graphs instantly
  • maintain multiple concept maps

๐Ÿ’ป Demo: Using the graph view in combination with path mode

Video Thumbnail


๐ŸŒŒ Knowledge Graph Explorer

Navigate complex subjects inside a fully interactive graph environment.

NodeScape supports both:

  • 3D exploration
  • 2D structured layout

This allows users to explore concepts spatially or in a structured hierarchy.

Desktop Controls

Action Result
Drag Rotate graph
Shift + Drag / Right Drag Pan camera
Scroll Zoom
Middle Drag Zoom camera
Arrow Keys Pan camera
Shift + Arrow Rotate camera
Drag Node Move node
Middle Click Node Lock camera to node


๐Ÿงญ Path Mode (Guided Knowledge Navigation)

NodeScape introduces a Path Mode that transforms the graph into a guided learning experience.

When enabled:

โ€ข the camera locks onto the current concept
โ€ข visited nodes form a breadcrumb path
โ€ข unvisited nodes appear as dotted connections
โ€ข unrelated parts of the graph are dimmed

This turns the graph into a learning pathway instead of a chaotic network.

Users can explore concepts through:

  • the 3D graph
  • connected node buttons
  • the node index sidebar
  • breadcrumb navigation


๐Ÿงฌ Hierarchy Layout

Large graphs can be difficult to understand.

NodeScape includes a Hierarchy Layout system that organizes nodes into levels.

This helps visualize structures such as:


Artificial Intelligence
โ”” Machine Learning
โ”” Neural Networks
โ”” CNN

The hierarchy system works with both 2D and 3D modes, helping reveal relationships between:

  • concepts
  • techniques
  • applications


๐ŸงŠ 2D Mode

For structured exploration, NodeScape includes a 2D projection mode.

This mode:

  • flattens the graph
  • reveals hierarchical layers
  • makes large knowledge maps easier to read

Users can switch freely between 2D and 3D views.


๐Ÿ“„ Node Pages (Concept Notes)

Clicking a node opens a detailed concept page.

Each node functions like a knowledge card containing:

  • formatted notes
  • contextual information
  • links to related nodes
  • Breadcrumb navigation (browser-style navigation) for nodes
  • Address bar

This creates a hybrid system between:


knowledge graph
+
note-taking system


๐Ÿง  Exploration-Focused Design

NodeScape is designed to make learning feel like exploring a map rather than reading a document.

Key ideas include:

  • spatial memory
  • visual connections
  • concept clustering
  • exploration paths

Instead of scrolling through notes, users navigate through ideas.


๐Ÿ›๏ธ Architecture

LLM (Llama 3.3 70B)
โ†“
Structured JSON Knowledge Graph
โ†“
NodeScape Parser
โ†“
3D Graph Renderer (Three.js + d3-force-3d)

AI generates structured concept graphs which NodeScape converts into an interactive knowledge universe.


๐ŸŽ›๏ธ AI Tools & Data Sidebars

NodeScape includes two powerful sidebars.

AI Data Sidebar (Right)

Used to generate and edit graphs.

Features:

  • AI chatbot for graph generation
  • prompt templates
  • paste AI-generated JSON
  • raw JSON editor
  • graph controls

Node Index Sidebar (Left)

Displays a hierarchical list of nodes.

Users can:

  • quickly jump to concepts
  • explore the graph structure
  • open nodes directly

๐ŸŽจ Glassmorphic UI

NodeScape features a modern UI built with:

  • Framer Motion
  • Tailwind CSS

Features include:

  • animated transitions
  • glassmorphic panels
  • dark / light themes
  • fluid UI interactions

๐Ÿ› ๏ธ Tech Stack

Frontend

  • React
  • TypeScript

Visualization

  • Three.js
  • d3-force-3d

Animation

  • Framer Motion

Styling

  • Tailwind CSS

๐Ÿš€ Getting Started

๐ŸŒŸ Live Demo

https://node-scape.vercel.app/


๐Ÿง  How To Create Knowledge Graphs

NodeScape supports three different ways to build knowledge graphs, depending on how you prefer to work.

๐Ÿค– 1. Built-in AI Chatbot

The easiest way to generate a knowledge graph.

Use the AI Chatbot in the right sidebar to automatically generate structured concept graphs.

Steps:

  1. Open the AI Data sidebar
  2. Ask the chatbot for a topic

Example:


Artificial Intelligence
Stoicism
Quantum Computing

  1. The AI produces structured JSON
  2. NodeScape instantly converts it into a 3D knowledge graph

This is the fastest way to explore new topics.


๐ŸŒ 2. External AI (Using Prompt Template)

NodeScape also works with external AI tools such as:

  • ChatGPT / Claude / Gemini etc.
  • Local LLMs

Steps:

  1. Copy the Graph Generation Prompt from prompt menu
  2. Paste it into your preferred AI model
  3. Ask for a topic (change the [TOPIC HERE] in the prompt)
  4. Copy the returned json
  5. Paste into paste section in paste menu

NodeScape will automatically render the graph.

This method allows using more powerful external models.


โœ๏ธ 3. Manual Graph Editing

NodeScape also supports fully manual graph creation.

Enable Edit Mode to:

  • create new nodes
  • connect nodes
  • rename concepts
  • write notes
  • move nodes in the graph

This allows you to build custom knowledge maps by hand, perfect for:

  • studying subjects
  • planning projects
  • mapping ideas
  • organizing research

These three workflows allow NodeScape to function as both: AI-powered knowledge generator + manual knowledge mapping tool

You can freely mix all three approaches while building your knowledge graphs.


๐ŸŒ Why NodeScape Exists

Most knowledge tools are linear.

Notes look like this:


Topic
โ”œ Subtopic
โ”œ Subtopic
โ”” Subtopic

But real knowledge does not grow linearly. Concepts connect across subjects, forming networks of ideas.

For example:


Artificial Intelligence
โ”œ Machine Learning
โ”‚  โ”œ Neural Networks
โ”‚  โ”‚  โ”œ CNN
โ”‚  โ”‚  โ”” Transformers
โ”‚  โ”” Clustering
โ”œ Robotics
โ”” Computer Vision

Traditional notes make it difficult to see these relationships. You scroll through pages of text instead of exploring how ideas connect. NodeScape was built to solve this problem.

Instead of reading knowledge like a document, NodeScape lets you:

  • navigate ideas spatially
  • see how concepts relate
  • explore topics naturally
  • build personal knowledge maps

It treats knowledge like a landscape, not a list. You donโ€™t just read information โ€” you explore it.


๐Ÿ”ฎ Future Roadmap

NodeScape is evolving toward becoming a self-expanding knowledge engine.

โ˜๏ธ Cloud Backend (Supabase)

Future versions of NodeScape will introduce a Supabase-powered backend to support persistent and collaborative knowledge graphs.

Planned capabilities include:

โ€ข Cloud graph storage โ€“ save graphs securely in a hosted database
โ€ข User authentication โ€“ personal graph libraries linked to accounts
โ€ข Cross-device sync โ€“ access your knowledge maps from anywhere
โ€ข Collaborative graphs โ€“ multiple users editing the same graph
โ€ข Graph version history โ€“ track how knowledge maps evolve over time
โ€ข Shared public graphs โ€“ publish and explore community knowledge maps

Supabase provides:

  • PostgreSQL database
  • authentication
  • real-time updates and multi-device sync
  • storage for graph assets

This will allow NodeScape to move beyond local storage and become a cloud-based knowledge mapping platform.


๐Ÿ” Graph Search

Search nodes by:

  • title
  • tags
  • content

๐Ÿ“„ Knowledge Extraction

Upload:

  • PDFs
  • Images
  • Documents

Automatically convert them into knowledge graphs.


๐Ÿค– Other External AI Integration

  • Ollama local models
  • OpenAI / Anthropic API integration

๐ŸŒฑ Self-Expanding Graphs

Nodes can dynamically generate:

  • missing concepts
  • deeper subtopics
  • related ideas

๐ŸŒŒ Visual Enhancements

  • bloom & glow effects
  • clustering of related nodes
  • automatic domain grouping
  • smarter layouts for large graphs

Other Future Roadmaps

  • Snapshots for graphs (Sub-Library for internal states of graphs, tracks changes, progress of users)
  • Arrow marks for showing directions between nodes
  • New object: Relationships (Shows how a node connects to another node huge change, for NodeScape V2 eg:-
(Human body) -> | has | -> (heart)
      ^            ^          ^
      |            |          |
      |            |          |
     node     Relationship   node   
  • Encapsulation of nodes (universe inside another universe):- node contains subgraph
  • branches (parallel universe)
  • clustering (implement a tag system)
  • Coloring nodes which are similar
  • Legends for the map [uses colored nodes]
  • Planet / Space mode:- Use displacement mapping generated by ai to create dynamic worlds which are explorable/walkable in first-person (walk through a planet of your knowledge), fly from planet to planet for switching topics (not really useful, just for fun)(NodeScape V4 feature)
  • Real-time collaboration for graph creation (Nodescape V3 feature)
websockets
conflict resolution
state syncing

allows users to build idea worlds together, see what paths each are taking

  • Neo4j or ArangoDB database for storage in far future
  • Django api server for ai features
  • AI graph history (previously generated graphs, chat history) using supabase, lets users track what AI created.
Graph generation
Graph expansion
Document โ†’ graph
Automatic concept suggestions
Saved Graphs
= final result

AI Generation History
= how the result was created
  • Redis Caching for generating frequently generated graphs instantly
  • Redis track popular graphs automatically and show: Trending knowledge graphs
  • Semantic caching systems to avoid regenerating results for similar prompts, not just identical ones
"Stoicism" โ†’ cached
"Stoicism philosophy" โ†’ NOT cached
"Stoic philosophy" โ†’ NOT cached

Even though they mean the same thing, the cache misses.

Semantic caching idea:- Instead of storing only the topic text, you store an embedding vector representing its meaning. Generate embeddings using a small model like all-MiniLM-L6-v2. Generated embeddings are stored in vector database (pgvector) Example embeddings:

Stoicism โ†’ [0.12, -0.45, 0.33, ...]
Stoic philosophy โ†’ [0.11, -0.44, 0.35, ...]
These vectors are very similar.

Semantic caching Architecture:

React (Vercel)
      โ†“
FastAPI
      โ†“
Embedding model
      โ†“
Vector similarity search
      โ†“
Redis / DB
      โ†“
LLM (only if needed)

How the system works When generating a graph

User topic
   โ†“
Create embedding
   โ†“
Search cache for similar embedding

If similarity > threshold (ex: 0.9):

Return cached graph

Otherwise:

Generate graph with LLM
Store embedding + graph
  • Mobile version in React Native (Nodescape V3)
  • Mini-Map for navigation (useful for mobile)

The primary focus are anything that improves the core mechanism: understanding, navigation learning flow


๐Ÿ‘จโ€๐Ÿ’ป Built by

Arjun S Nair

About

๐ŸŒŒ NodeScape โ€” Explore knowledge in 3D / 2D. An interactive AI-powered knowledge graph explorer built with Three.js, combining visualization, note-taking, and idea exploration in a dynamic network of concepts.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages