Skip to content
Β 
Β 

Repository files navigation

Z-PRISM

Intelligence. Crystallized.

A 3D knowledge graph for Obsidian with golden angle coloring β€” see your ideas as nature intended.


Why Z-PRISM?

Your knowledge deserves better than a flat, monochrome graph. Z-PRISM transforms your vault into a living 3D constellation where:

  • Every domain has a distinct color β€” using the golden angle (137.508Β°), the same mathematics that arranges sunflower seeds
  • Related notes cluster together β€” force-directed physics groups connected ideas
  • Zoom reveals structure β€” labels appear as you focus, disappear as you pan out
  • Cross-domain bridges glow β€” see where your knowledge connects across disciplines

Features

Feature Description
3D Force-Directed Graph Navigate your vault in three dimensions
Golden Angle Coloring 26+ distinct domain colors, mathematically optimal
Zoom-Based Labels Labels appear/hide based on zoom level
Real-Time Physics Tune center force, repel force, link distance
Path/Tag Filtering Focus on specific folders or tags
Dark/Light Mode Automatic theme detection

The Golden Angle

Golden Angle = 360Β° / φ² β‰ˆ 137.508Β°

This angle appears in nature β€” sunflower spirals, galaxy arms, leaf arrangements. When applied to colors:

  • No repetition β€” colors follow a Fibonacci spiral
  • No clustering β€” adjacent folders have maximum contrast
  • Scales infinitely β€” works for 5 folders or 500

Installation

From Obsidian Community Plugins (Coming Soon)

  1. Open Settings β†’ Community Plugins
  2. Search for "Z-PRISM"
  3. Install and enable

Manual Installation

  1. Download the latest release from Releases
  2. Extract to .obsidian/plugins/pilan-z-prism/
  3. Enable in Settings β†’ Community Plugins

Usage

  1. Open Command Palette (Cmd/Ctrl + P)
  2. Search "Z-PRISM: Open 3D Graph"
  3. Navigate with mouse:
    • Drag to rotate
    • Scroll to zoom
    • Click node to open note
  4. Use settings panel to customize physics and colors

Part of PILAN

Z-PRISM is part of the PILAN ecosystem β€” tools for crystallizing intelligence.

Tool Purpose
mnemo Memory for AI-assisted development
UMBRA Personal knowledge architecture
Z-PRISM 3D knowledge visualization (you are here)

Attribution

Z-PRISM is built on the excellent work of Alexander Weichart and the obsidian-3d-graph community.

We're grateful for open source. MIT License preserved.

Development

# Clone
git clone https://github.com/0xRaghu/pilan-z-prism.git
cd pilan-z-prism

# Install dependencies
npm install

# Development mode (watches for changes)
npm run dev

# Build for production
npm run build

License

MIT License β€” see LICENSE


@pilan_ai Β· pilan.ai

About

πŸ‘“ A 3D graph for Obsidian!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages