---
title: InsightFlow AI
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: true
# app_port: 7860 # App port is usually not needed here if using standard Chainlit port or Docker EXPOSE
short_description: "AI research assistant: RAG, visuals, multi-perspective"
---

# InsightFlow AI: Multi-Perspective Research Assistant

InsightFlow AI is an advanced research assistant that analyzes topics from multiple perspectives, providing a comprehensive and nuanced understanding of complex subjects. It now features Retrieval Augmented Generation (RAG) for supported personas and a streamlined UI using Chainlit's chat settings.

![InsightFlow AI](https://huggingface.co/datasets/suhas/InsightFlow-AI-demo/resolve/main/insightflow_banner.png)

## Features

### Multiple Perspective Analysis
- **Analytical**: Logical examination with methodical connections and patterns
- **Scientific**: Evidence-based reasoning grounded in empirical data
- **Philosophical**: Holistic exploration of deeper meaning and implications
- **Factual**: Straightforward presentation of verified information
- **Metaphorical**: Creative explanations through vivid analogies
- **Futuristic**: Forward-looking exploration of potential developments

### Personality Perspectives
- **Sherlock Holmes**: Deductive reasoning with detailed observation
- **Richard Feynman**: First-principles physics with clear explanations
- **Hannah Fry**: Math-meets-society storytelling with practical examples

### Visualization Capabilities
- **Concept Maps**: Automatically generated Mermaid diagrams showing relationships
- **Visual Notes**: DALL-E generated hand-drawn style visualizations of key insights
- **Visual-Only Mode**: Option to focus on visual representations for faster comprehension (via Settings)

### Retrieval Augmented Generation (RAG)
- Supported personas (e.g., Analytical, Philosophical, Metaphorical) can search dedicated knowledge bases for more informed answers.
- Toggle RAG functionality via the Settings panel.

### Export Options
- **Markdown Export**: Save analyses as formatted markdown with embedded visualizations
- **PDF Export**: Generate professionally formatted PDF documents

## How to Use

1.  **Configure Settings (⚙️ icon)**: 
    *   Select a Persona Team (e.g., Balanced Overview) or toggle individual personas.
    *   Adjust other settings like RAG, Direct Mode, Quick Mode, and visibility of perspectives/visualizations.
2.  **Ask Your Question**: Type any research question or topic to analyze.
3.  **Review Insights**: Explore the synthesized view and (if enabled) individual perspectives and visualizations.
4.  **Get Help**: Type `/help` for a detailed guide on features and settings.
5.  **Export Results**: Use `/export_md` or `/export_pdf` to save your analysis (Note: Full export functionality is under development).

## Commands

Most settings are now conveniently managed via the **Settings (⚙️) panel** in the UI.
Type `/help` for a comprehensive guide to all features and settings.

```
# Core Commands
/help                  - Displays a detailed help message about features and settings.

# Mode Toggles (Also available in Settings)
/direct on|off         - Toggle direct LLM mode (bypasses multi-persona).
/perspectives on|off   - Toggle showing individual perspectives.
/visualization on|off  - Toggle showing visualizations (Mermaid & DALL-E).
/quick_mode on|off     - Toggle Quick Mode (uses a smaller, predefined set of personas).
/rag on|off            - Toggle Retrieval Augmented Generation for supported personas.

# Export Options (Functionality under development)
/export_md             - Export the current insight analysis to a markdown file.
/export_pdf            - Export the current insight analysis to a PDF file.

# Legacy Persona Commands (Advanced - Consider using Settings panel for primary persona management)
# /add [persona_name]    - Add a perspective to your research team
# /remove [persona_name] - Remove a perspective from your team
# /list                  - Show all available perspectives
# /team                  - Show your current team and settings
```

## Example Topics

- Historical events from multiple perspectives
- Scientific concepts with philosophical implications
- Societal issues that benefit from diverse viewpoints
- Future trends analyzed from different angles
- Complex problems requiring multi-faceted analysis

## Technical Details

Built with Python using:
- LangGraph for orchestration
- OpenAI APIs for reasoning and visualization
- Chainlit for the user interface
- Custom persona system for perspective management

## Try These Examples

- "The impact of artificial intelligence on society"
- "Climate change adaptation strategies"
- "Consciousness and its relationship to the brain"
- "The future of work in the next 20 years"
- "Ancient Greek philosophy and its relevance today"

## Feedback and Support

For questions, feedback, or support, please open an issue on the [GitHub repository](https://github.com/suhas/InsightFlow-AI) or comment on this Space.