🧠 Progressive Mindmap

AI-powered knowledge extraction from conversations — visualized as mindmaps

中文文档

---

Why I built this: After countless conversations with LLMs, I found myself drowning in insights — brilliant answers buried in long chat histories, impossible to review or recall. I needed a way to automatically distill conversations into structured knowledge I could revisit at a glance. That's why Progressive Mindmap exists: it turns scattered Q&A into a living mindmap that grows with every conversation.

Progressive Mindmap is a local-first web application that transforms your LLM conversations into structured, editable mindmaps. Unlike traditional mindmap tools where you draw nodes manually, Progressive Mindmap extracts knowledge automatically: chat with any OpenAI-compatible LLM, select the insights you want to keep, and let the AI build a mindmap — with incremental updates that preserve your edits across regenerations.

✨ Features

🤖 AI-Native Mindmap Generation

• Conversation to Knowledge Graph — LLM analyzes your chats and produces structured trees
• Incremental Operations — AI outputs surgical edits (add_child, update, merge, delete_leaf) instead of full regeneration
• Editable Nodes — double-click to edit; AI respects your edits (protected by editedByUser flag)

📚 Corpus & Provenance

• Source Tracking — every node shows which conversation messages informed it
• Material Curation — select entire messages or text fragments as source material
• Conversation Monitoring — auto-capture new AI responses into the mindmap corpus

🎨 Canvas & Interaction

• React Flow Canvas — smooth pan/zoom with @xyflow/react + dagre layout
• Drag-to-Reparent — restructure your mindmap by dragging nodes
• Right-Click Menu — add child, move, delete with context menu
• Collapse/Expand — toggle branches for focused viewing
• Full-Screen Mode — immersive mindmap exploration

⚙️ Customizable

• Configurable Depth — 3/4/5 levels or "Auto" (AI decides)
• Multi-Provider — works with OpenAI, DeepSeek, Ollama, SiliconFlow, and any OpenAI-compatible API
• Per-Mindmap Model — different mindmaps can use different models for generation

💾 Local-First & Private

• IndexedDB Storage — all data stays in your browser
• No Backend — direct API calls from your browser
• No Account Required — you own your data

🏗️ Architecture

┌────────────────────────────────────────────────────────┐
│                     Chat Interface                      │
│  ┌──────────┐  ┌───────────┐  ┌────────────────────┐  │
│  │ Sidebar  │  │ Messages  │  │   Mindmap Panel    │  │
│  │          │  │           │  │  ┌──────────────┐   │  │
│  │ Sessions │  │ User/AI   │  │  │ React Flow   │   │  │
│  │ Mindmaps │  │ Markdown  │  │  │ Canvas       │   │  │
│  │          │  │ Selection │  │  │ dagre Layout │   │  │
│  └──────────┘  └───────────┘  │  └──────────────┘   │  │
│                                │  ┌──────────────┐   │  │
│                                │  │ Corpus Panel │   │  │
│                                │  └──────────────┘   │  │
│                                └────────────────────┘  │
├────────────────────────────────────────────────────────┤
│                    Data Layer                           │
│  ┌──────────┐  ┌───────────┐  ┌────────────────────┐  │
│  │ Provider │  │Conversation│  │     MindMap        │  │
│  │  Store   │  │   Store    │  │      Store         │  │
│  │ (IDB)    │  │  (IDB)     │  │     (IDB)          │  │
│  └──────────┘  └───────────┘  └────────────────────┘  │
├────────────────────────────────────────────────────────┤
│               AI Generation Pipeline                   │
│  ┌──────────┐  ┌───────────┐  ┌────────────────────┐  │
│  │ Corpus   │→ │ Prompt    │→ │ OpenAI-compatible  │  │
│  │ Collector│  │ Builder   │  │ LLM API            │  │
│  └──────────┘  └───────────┘  └────────────────────┘  │
│                                     ↓                  │
│  ┌──────────┐  ┌───────────┐  ┌────────────────────┐  │
│  │ Validate │← │ Parse /   │← │ JSON / Markdown    │  │
│  │ & Apply  │  │ Increment │  │ Response           │  │
│  └──────────┘  └───────────┘  └────────────────────┘  │
└────────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

• Node.js 18+
• An API key from any OpenAI-compatible provider (OpenAI, DeepSeek, Ollama, etc.)

Install & Run

git clone https://github.com/web4zn/progressive-mindmap.git
cd progressive-mindmap
npm install
npm run dev

Open http://localhost:5173, add your API provider in Settings, and start chatting. Create a mindmap from the sidebar to begin extracting knowledge!

Build

npm run build    # TypeScript check + production build
npm run preview  # Preview production build

🧪 Development

npm test              # Run unit & component tests (131 tests)
npx tsc --noEmit      # Type check
npx vitest --watch    # Watch mode

🗺️ Roadmap

• LLM chat with multi-provider & streaming
• AI mindmap generation (full rebuild)
• Incremental update operations
• Corpus curation & source tracking
• React Flow canvas with dagre layout
• IndexedDB persistence
• Real-time streaming mindmap preview during generation
• PNG / SVG / Markdown export
• Keyboard shortcuts
• Undo / Redo
• Rich content in nodes (images, links, notes)
• Plugin architecture
• Multiple layout types (org chart, fishbone, timeline)
• Theme system

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for how to get started.

📄 License

MIT — see LICENSE for details.