Skip to main content

​
Get Started in 3 Minutes

This guide will walk you through creating your first research notebook with DecipherIt. You’ll learn how to create an account, add research sources, and generate AI-powered insights.
1

Create Your Account

Visit decipherit.xyz and click Get Started or Sign In.Create your account using:
  • Email and password
  • GitHub OAuth (recommended for developers)
DecipherIt uses Better Auth for secure, modern authentication with Prisma ORM for data management.
Using GitHub OAuth? You’ll be automatically redirected to your dashboard after authentication.
2

Create Your First Notebook

Once logged in, you’ll see your dashboard. Click Create New Notebook or the + button.You’ll be presented with options to add research sources:

​
Research Source Options

Enter any topic you want to research. Examples:
  • “Latest developments in quantum computing”
  • “Climate change impact on coastal cities”
  • “Best practices for React 19”
What happens: The Web Scraping Planner creates a strategic research plan, the Link Collector Agent uses Bright Data’s search_engine to find relevant sources globally, and the Web Scraper Agent extracts content using scrape_as_markdown.
You can combine multiple source types in a single notebook! For example, upload a PDF, add some URLs, and enter a research topic.
3

AI Processing Begins

Click Create Notebook to start the AI processing pipeline.

​
What Happens Behind the Scenes

Vector Embeddings - Content is chunked and converted to embeddings using OpenAI’s embedding models, then stored in Qdrant vector database for semantic search.Research Analysis - The Research Analyst agent synthesizes information from all sources, identifying key themes and insights.FAQ Generation - AI agents automatically analyze content patterns and generate relevant questions with comprehensive answers.
These features generate when you request them:Audio Overviews - Click the audio button to trigger the Podcast Script Generator agent, which creates conversational scripts converted to high-quality audio using LemonFox TTS with multiple AI voices (Michael and Sarah).Mindmaps - Request a mindmap to trigger the Content Analyzer and Mindmap Creator agents, which analyze research structure and generate hierarchical visualizations with up to 5 levels of depth using react-mindmap-visualiser.Interactive Q&A - Ask questions anytime using natural language. The Decipher agent uses vector similarity search through Qdrant to retrieve relevant context and provide accurate answers.
Processing time varies based on source quantity and complexity. Topic research typically takes 2-5 minutes as multiple CrewAI crews work in parallel.
4

Explore Your Research Notebook

Once processing completes, your notebook opens with multiple tabs:

​
Notebook Features

Summary

AI-generated comprehensive summary created by Research Analyst and Content Writer agents working together

Q&A Chat

Interactive chat powered by Qdrant vector search and the Decipher agent - ask anything about your research

FAQs

Automatically generated questions and answers from AI content analysis

Sources

All source materials with links to original content and page titles

Audio Overview

Generate podcast-style audio discussion (4-5 minutes) with multiple AI voices

Mindmap

Interactive visual hierarchy showing research structure and relationships

​
Example Use Cases

Upload research papers (PDFs), add relevant URLs, and enter your research topic. Get comprehensive summaries, auto-generated FAQs for study guides, and interactive Q&A to explore concepts.Best for: Literature reviews, thesis research, learning new subjects
Enter a topic you’re writing about and add specific URLs. Get AI-synthesized insights from multiple sources, generate FAQs for your audience, and create audio versions of your research.Best for: Blog posts, articles, content creation, journalism
Research competitors, industry trends, or market conditions. Add URLs from industry reports, news articles, and company websites. Get structured summaries and visual mindmaps of market landscape.Best for: Business analysis, competitive intelligence, trend research
Upload documentation files, add official docs URLs, and ask technical questions. Get clear explanations and generate FAQs for your team.Best for: Technology learning, API research, framework documentation

​
Understanding AI Processing

​
CrewAI Agents at Work

DecipherIt employs multiple specialized AI crews:

Planning Crew

Web Scraping Planner strategizes optimal data collection approaches for your research topic

Discovery Crew

Link Collector Agent uses search_engine to find relevant sources globally

Scraping Crew

Web Scraper Agent uses scrape_as_markdown to extract clean, structured content

Analysis Crew

Research Analyst synthesizes information from multiple sources

Content Crew

Content Writer creates engaging, well-structured summaries

FAQ Crew

FAQ Generator automatically creates relevant Q&A pairs

Visualization Crew

Mindmap Creator analyzes structure for hierarchical visual representations

Audio Crew

Script Writer and TTS agents create podcast-style conversations

​
Next Steps

Explore All Features

Learn about every feature in detail

Deep Research

Master topic-based research with Bright Data

Interactive Q&A

Learn how vector search powers conversations

Audio Overviews

Generate podcast-style audio summaries
Pro Tip: Combine multiple source types for the most comprehensive research. Upload PDFs, add URLs, and enter topics together for richer insights!

​
Need Help?

GitHub Issues

Report bugs or request features

Architecture Guide

Understand how DecipherIt works under the hood

Build docs developers (and LLMs) love

Get started for freeTalk to us