InsightFlowAI_test / README.md
suh4s
Updated readme for huggingface
c128e9b
metadata
title: InsightFlow AI
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: true
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

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 or comment on this Space.