Real-time 3D knowledge graph exploration powered by Rust, CUDA GPU physics, OWL 2 ontology reasoning, and a multi-agent AI mesh.

← Back to Project | Quick Start | API Reference | Architecture

git clone https://github.com/DreamLab-AI/VisionClaw.git
cd VisionClaw && cp .env.example .env
docker-compose --profile dev up -d

Open http://localhost:3001 for the 3D graph interface, http://localhost:4000/api for the REST API, and http://localhost:7474 for the Neo4j browser.

Full setup details: Deployment Guide

Known Issues: Before debugging unexpected behaviour, check KNOWN_ISSUES.md — it tracks active P1/P2 bugs including the Ontology Edge Gap (ONT-001) and V4 delta instability (WS-001).

graph LR
    subgraph "Tutorials"
        T1[Installation]
        T2[First Graph]
        T3[Neo4j Basics]
    end
    subgraph "How-To"
        H1[Deployment Guide]
        H2[Development Guide]
        H3[Agent Orchestration]
        H4[Features]
        H5[Operations]
    end
    subgraph "Explanation"
        E1[System Overview]
        E2[Backend CQRS]
        E3[Actor Hierarchy]
        E4[Client Architecture]
        E5[Ontology Pipeline]
        E6[Physics/GPU Engine]
        E7[XR Architecture]
        E8[Enterprise Contexts BC11-17]
    end
    subgraph "Reference"
        R1[REST API]
        R2[WebSocket Binary V5]
        R3[Neo4j Schema]
        R4[Agents Catalog]
        R5[Config & Env]
    end
    subgraph "Enterprise"
        ADR40[ADR-040 Identity]
        ADR41[ADR-041 Broker]
        ADR46[ADR-046 UI Arch]
        PRD2[PRD-002 Enterprise]
    end

Step-by-step lessons that teach VisionClaw by doing.

Practical task-oriented instructions. See how-to/README.md for the full index.

Conceptual deep-dives that build understanding of how and why VisionClaw works.

Technical specifications for APIs, schemas, protocols, and configuration.

Full reference index: reference/INDEX.md

Design decisions recorded as ADRs in docs/adr/.

ADR-015 through ADR-026 are not in this repository — those numbers were assigned to decisions that predated the current ADR process and were not backfilled.

ADR-035 is absent — the content was renumbered to ADR-037 (ADR-037-binary-protocol-consolidation.md carries the ADR-035 internal heading, a known inconsistency).

Six of eight enterprise ADRs are Proposed — the features are built and operational but the decisions are pending formal ratification.

Exploratory design documents in docs/design/.

• Nostr Relay Integration — Architecture for VisionClaw ↔ Nostr relay bridging
• Nostr Solid Browser Extension — Browser extension design for Nostr + Solid identity
• Enterprise Drawer UI — Full specification for the enterprise slide-out drawer: geometry, WASM ambient effects, Zustand store, keyboard shortcut, ARIA, graph dimming, rollback plan
• Insight Migration Loop — Research corpus for the tacit→explicit knowledge bridging workflow (prior art, bridge theory, physics mapping, acceptance tests, scoring)

QE audit reports in docs/audits/.

Industry applications and positioning in docs/use-cases/.

Maintained by DreamLab AI — Issues | Discussions