👁️ perspektive.js

The first open-source multi-manifold React renderer for Neuro-Symbolic AI

🧠 The Name: Nietzsche's Perspektivismus

"There are no facts, only interpretations." — Friedrich Nietzsche, Notebooks, 1886

The name perspektive is not random. It comes directly from Nietzsche's central philosophical doctrine: Perspektivismus (Perspectivism).

Nietzsche argued that there is no single, God's-eye view of reality — only perspectives. Every observation, every truth, every piece of knowledge is shaped by the position from which it is seen. A fact seen from one angle is a distortion seen from another. The richer your set of perspectives, the closer you get to truth.

This is exactly the problem with modern AI visualization:

We have been looking at high-dimensional AI thought from a single Euclidean perspective — and calling the resulting chaos "a graph."

perspektive.js was built to give AI interpretability its Nietzschean correction:

• 🌌 Poincaré is the perspective of hierarchy — where depth is infinite and the center is everywhere
• 🧭 Klein is the perspective of direction — where the shortest path is always a straight line
• ⏳ Minkowski is the perspective of causality — where time is a geometric axis, not an afterthought
• ⚛️ Bloch is the perspective of superposition — where a thought exists in multiple states until observed

Just as Nietzsche demanded we abandon the single "objective" lens, we demand you stop flattening intelligence into Euclidean space.

See AI thoughts as they truly are — from every manifold at once.

Euclidean geometry failed the modern AI era.

When we try to visualize RAGs, Knowledge Graphs and LLM memories in flat 2D space (D3.js, Vis.js, Cytoscape), the result is always the same useless hairball.

perspektive.js is the first React + WebGL library built from scratch to render AI thoughts across real geometric manifolds (Multi-Manifold Rendering).

🌌 Why Perspektive?

Standard graph libraries assume flat Euclidean space. Render 10,000+ LLM memory nodes and they collapse into visual noise.

The math behind LLMs lives in high-dimensional space — which behaves far more like hyperbolic geometry than flat space.

perspektive.js projects your graph coordinates directly into non-Euclidean manifolds via WebGL:

| Manifold | Visualization | Best for | |---|---|---| | 🌌 Poincaré Disk | Hierarchical trees with natural fractal compression at the edges | Hierarchical RAG, taxonomies | | 🧭 Klein Model | Perfectly straight geodesic lines | Optimal semantic paths | | ⏳ Minkowski Light Cones | Temporal causality made visible | AGI reasoning timelines | | ⚛️ Bloch Sphere | Arousal and semantic entanglement as quantum states | Quantum associative memory |

🚀 Quick Start

npm install perspektive

import { PerspektiveView } from 'perspektive';

const aiMemory = {
  nodes: [
    { id: '1', embedding: [0.1, 0.4], label: 'Symptom X', energy: 0.9 },
    { id: '2', embedding: [-0.3, 0.2], label: 'Treatment Y', energy: 0.5 }
  ],
  edges: [
    { source: '1', target: '2', weight: 0.8 }
  ]
};

function App() {
  return (
    <PerspektiveView
      data={aiMemory}
      manifold="poincare"
      enableHeatDiffusion={true}
    />
  );
}

✨ v0.1.0 Features

• 🌌 Poincaré Disk — fractal expansion, zero overlap at scale
• 🧭 Klein Model — semantic routes as perfect straight lines
• ⏳ Minkowski Light Cones — see literally what caused what
• ⚛️ Bloch Sphere — quantum fidelity and semantic entanglement
• 🔀 Counterfactual UI — drag nodes to create "what-if" hypotheses (quantum entanglement visual)
• ⏪ Causal Scrubber — rewind AGI decisions along the time axis
• 🗺️ Fractal Loader — hyperbolic lazy loading, Google Maps style (unlimited nodes)
• 🌊 Live Pregel Diffusion — real-time Chebyshev heat diffusion via WebSocket
• 🫧 Probability Cloud Shaders — nodes as volumetric quantum clouds (GLSL raymarching)
• 👥 Community Hulls — Louvain clusters as colored convex hulls
• ✨ A* Path Highlight — optimal routes with animated pulse
• 📦 WebSocket Streaming — GraphStore with delta-ops born/died/changed at 60fps
• 🎨 Multi-theme — cyberpunk + customizable presets
• ♿ Accessible — keyboard and screen reader ready

🧩 API

import {
  PerspektiveView,
  CounterfactualOverlay,
  CausalScrubber,
  CommunityHulls,
  PathHighlight,
  useFractalLoader,
  useDiffusionWebSocket,
  BlochMaterial,
  GraphStore,
} from 'perspektive';

PerspektiveView Props

interface PerspektiveProps {
  data: GraphData;
  manifold?: 'poincare' | 'klein' | 'minkowski' | 'emotion' | 'riemann';
  width?: number | string;
  height?: number | string;
  enableHeatDiffusion?: boolean;
  enableCounterfactual?: boolean;
  enableFractalLoad?: boolean;
  fractalApiBase?: string;
  onNodeClick?: (node: NodeData) => void;
  onCounterfactualCreate?: (sourceId: string, targetId: string) => void;
  theme?: 'cyberpunk' | 'minimal' | 'academic';
}

🗺️ Roadmap: Toward the AGI Retina

Building more than a renderer — building the visual cortex for autonomous systems.

1. Causal Scrubber ✅ — Rewind and audit the causal chain of AGI decisions (Minkowski Time Machine)
2. Counterfactual UI ✅ — Quantum drag-and-drop to create visual hypotheses
3. Immersive WebXR — Walk physically into AI memory using VR/AR headsets
4. Probability Cloud Shaders ✅ — Volumetric GLSL raymarching for Bloch emulations
5. Bio-Growth Animation — Real-time neuroplasticity and L-System topology evolution
6. Latent Walk "Dreaming" — Smooth interpolation across manifolds to discover unmapped semantic bridges
7. Python/Jupyter Bindings — ipywidgets for data scientists
8. GPU BVH — Bounding Volume Hierarchy for sub-ms raycasting

🧠 Powered by

Originally built as the visual cortex of NietzscheDB — The Temporal Hyperbolic Graph Database for AGI.

📦 Stack

• React 18/19 + TypeScript
• Three.js + @react-three/fiber + @react-three/drei
• Zustand (graph state)
• WebGL 2.0 custom shaders
• WebSocket + FlatBuffers (high-performance binary streaming)

🤝 Contributing

PRs are very welcome. If you work with RAG, neuro-symbolic AI, AGI interpretability or differential geometry — you are exactly who makes this library grow.

git clone https://github.com/JoseRFJuniorLLMs/perspektive.js
cd perspektive.js
npm install
npm run dev

License

MIT — Build the future of AGI interpretability.

npm · GitHub · NietzscheDB

Stop flattening AI thoughts. See them as they truly are — in exponential space. 👁️