Overview
DecipherIt creates interactive visual mindmaps from your research content, helping you understand relationships, hierarchies, and structure at a glance. Using CrewAI agents and the react-mindmap-visualiser library, it transforms complex research into intuitive visual diagrams.Mindmaps are generated on-demand with adaptive depth (2-5 levels) based on content complexity.
How It Works
Content Retrieval
All research content is fetched from the vector database.Data Collection:
- All chunks retrieved from Qdrant by notebook ID
- Content sorted by chunk index
- Assembled into complete research text
- Passed to mindmap generation crew
backend/agents/mindmap_agent.py:144-161Content Analysis
The Content Analyzer agent identifies hierarchical themes and relationships.Analysis Process:
- Determines appropriate depth (2-5 levels) based on complexity
- Identifies ONE main central topic
- Breaks down into primary categories (3-6)
- Finds secondary subtopics (2-5 per category)
- Extracts detailed aspects if warranted
- Creates clear parent-child relationships
backend/agents/mindmap_agent.py:29-58Structure Creation
The Mindmap Creator agent builds the hierarchical node structure.Node Structure:
- Root node with single main topic
- Unique IDs for all nodes (“root”, “1”, “2”, etc.)
- Text labels (1-4 words each)
- Nested arrays for child nodes
- Empty arrays [] for leaf nodes
backend/agents/mindmap_agent.py:60-133Generating Mindmaps
- First Generation
- Interacting with Mindmap
- Regeneration
- Navigate to your processed notebook
- Click the Mindmap tab
- Click Generate Mindmap button
- Wait 1-3 minutes for processing
- Interactive mindmap appears when ready
The page automatically polls for completion every 3 seconds.
Mindmap Structure
Adaptive Depth Levels
Mindmaps automatically adapt to content complexity:- Simple Content (2-3 levels)
- Moderate Content (3-4 levels)
- Complex Content (4-5 levels)
Example: Brief article or single documentCharacteristics:
- Clear, focused topics
- Limited sub-themes
- Straightforward relationships
Technical Implementation
CrewAI Agent Configuration
backend/agents/mindmap_agent.py:8-141
Node Structure Format
backend/models/mindmap_models.py
Analysis Task Configuration
backend/agents/mindmap_agent.py:29-58
Visual Rendering
React Component Implementation
client/components/notebook/visual-mindmap.tsx:21-108
Color-Coded Levels
Nodes are automatically color-coded by depth:Level 0
Default - Root node (main topic)
Level 1
Info - Primary categories (blue)
Level 2
Success - Subtopics (green)
Level 3
Warn - Details (yellow)
Level 4
Danger - Specifics (red)
Status Management
Client-Side State
client/components/notebook/notebook-polling.tsx:220-223
Polling Implementation
client/components/notebook/notebook-polling.tsx:226-268
Mindmap Quality Features
Adaptive Complexity
Depth automatically adjusts to content complexity - simple topics get simpler maps.
Concise Labels
1-4 word labels keep the mindmap clean and readable at any zoom level.
Logical Grouping
Related concepts naturally grouped under common parent nodes.
Visual Hierarchy
Color coding and spatial layout make hierarchy immediately apparent.
Use Cases
Understanding Structure
Understanding Structure
Use mindmaps to:
- Quickly grasp research organization
- Identify main themes at a glance
- Understand topic relationships
- See content hierarchy visually
Presentations
Presentations
Mindmaps help with:
- Creating presentation outlines
- Explaining complex topics visually
- Showing research breadth
- Organizing talking points
Learning
Learning
Visual learning through:
- Spatial understanding of topics
- Progressive detail exploration
- Pattern recognition
- Memory aids via visualization
Research Planning
Research Planning
Mindmaps reveal:
- Topic coverage gaps
- Areas needing deeper research
- Connection opportunities
- Content balance issues
Interactive Features
Pan & Zoom
Click and drag to pan, scroll to zoom for exploring large mindmaps.
Expand/Collapse
Click nodes to show or hide their children for focused exploration.
Responsive Layout
Mindmap adapts to screen size for mobile and desktop viewing.
Performance Optimizations
Memoized Processing
Tree data processing is memoized to prevent unnecessary recalculations.
Efficient Rendering
react-mindmap-visualiser uses SVG for crisp, performant rendering at any scale.
Progressive Loading
Polling updates UI progressively without blocking interactions.
Smart Validation
Pydantic models ensure valid structure before rendering attempts.
API Endpoint
Generate Mindmap
client/app/api/notebooks/[id]/mindmap/route.ts
Best Practices
Limitations
Troubleshooting
Mindmap Too Simple
Mindmap Too Simple
If mindmap lacks detail:
- Content may be too brief for deep analysis
- Try adding more sources
- Ensure sources have substantial content
- Consider regenerating for different interpretation
Mindmap Too Complex
Mindmap Too Complex
If mindmap is overwhelming:
- Use collapse feature to simplify view
- Focus on specific branches
- Zoom in to readable level
- Content may be very comprehensive (expected)
Generation Failed
Generation Failed
If generation shows ERROR:
- Click “Try Again” to regenerate
- Check that research processed successfully
- Verify notebook has content
- Contact support if persists
Related Features
AI Summaries
Read detailed research summary
FAQ Generation
Explore auto-generated questions
Interactive Q&A
Ask specific questions about topics