Deep Research

Deep Research is an open source library for conducting deep, multi-hop research with reasoning capabilities. It performs focused web searches with recursive exploration to provide comprehensive, evidence-backed answers to complex questions.

Perplexity and OpenAI's Deep Research is gatekeeped and close sourced, So we decided to built the opposite—an open, fully customizable deep research framework.

✨ Key Features

Deep Research is designed to be your comprehensive solution for AI-powered research:

• 🧠 Advanced multi-hop reasoning for complex questions
• 🌐 Real-time web search with recursive exploration
• 🔍 Automatic subquery generation for comprehensive coverage
• 📊 Intelligent depth and breadth control for research thoroughness
• 📝 Evidence-based report generation with proper citations
• 📚 Automatic bibliography generation with source tracking
• 🔄 Iterative research cycles for deeper understanding
• 🤖 Multi-model support with specialized reasoning capabilities
• ⚡ Flexible configuration for customizing research parameters
• 📈 Scalable from simple inquiries to complex research problems

🧱 Core Concepts

| Concept | Description | | ----------------- | -------------------------------------------------------------------------------------------------------------------- | | Deep Thinking | The system breaks down a question into logical parts, reasons through them independently, and synthesizes an answer. | | Deep Research | The system performs multi-hop, focused web searches, compares the findings, and composes an evidence-backed answer. |

🚀 Installation

npm i deep-research
# or
yarn add deep-research
# or
bun i deep-research

🚀 Quick Start

Basic Usage

import { createDeepResearch } from "deep-research";

// Create instance using the factory function with default settings
const deepResearch = createDeepResearch({
  OPENAI_API_KEY: process.env.OPENAI_API_KEY,
  GEMINI_API_KEY: process.env.GEMINI_API_KEY,
  OPENROUTER_API_KEY: process.env.OPENROUTER_API_KEY,
  JIGSAW_API_KEY: process.env.JIGSAW_API_KEY,
});

// Research prompt
const prompt = "What are the recent developments in quantum computing?";

// Generate research report
const result = await deepResearch.generate(prompt);

console.log(result.data.text);
console.log(result.data.bibliography);

Advanced Usage

import { createDeepResearch } from "deep-research";
import { createGoogleGenerativeAI } from "@ai-sdk/google";
import { createOpenRouter } from "@openrouter/ai-sdk-provider";
import { createOpenAI } from "@ai-sdk/openai";

// Initialize AI providers
const gemini = createGoogleGenerativeAI({
  apiKey: process.env.GEMINI_API_KEY,
});

const openaiProvider = createOpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

const openRouterProvider = createOpenRouter({ 
  apiKey: OPENROUTER_API_KEY! 
})

// Get model instances
const geminiModel = gemini("gemini-2.0-flash");
const deepseekModel = openRouterProvider("deepseek-ai/DeepSeek-R1");
const openaiModel = openaiProvider("gpt-4o");

// Create instance with custom configuration
const deepResearch = createDeepResearch({
  max_output_tokens: 30000, // Hard upper limit of tokens
  target_output_tokens: 10000, // Target report length
  max_depth: 4, // specify how many iterations of research to perform
  max_breadth: 3, // specify how many subqueries to generate
  models: {
    default: openaiModel, // Custom models from AI SDK
    reasoning: deepseekModel,
    output: geminiModel,
  },
  logging: {
    enabled: true, // Enable console logging
  },
});

// Research prompt
const prompt = "What are the recent developments in quantum computing?";

// Generate research report
const result = await deepResearch.generate(prompt);

console.log(result.data.text);
console.log(result.data.bibliography);

Configuration Options for Deep Research

| Category | Option | Type | Default | Description | |----------|--------|------|---------|-------------| | max_depth | - | Number | 3 | Controls how many iterations of research the system will perform. Higher values allow for more thorough, multi-hop research. The system will continue researching until it has a complete answer or reaches this limit. | | max_breadth | - | Number | 3 | Controls how many subqueries are generated for each research iteration. Higher values enable wider exploration of the topic. Determines how many parallel search paths are pursued. | | max_output_tokens | - | Number | 32000 | Hard upper limit on the length of the final report. Must be greater than target_output_tokens. | | target_output_tokens | - | Number | optional | The ideal length for the generated report. The system will try to produce a report of approximately this length. | | models | default | LanguageModelV1 | GPT-4o | The primary model used for most operations. | | | reasoning | LanguageModelV1 | DeepSeek-R1 | Model used for reasoning about search results. | | | output | LanguageModelV1 | GPT-4o | Model used for generating the final report. | | logging | enabled | Boolean | false | When set to true, enables detailed console logging. Helpful for debugging and understanding the research process. | | API Keys | JIGSAW_API_KEY | String | required | For accessing the JigsawStack API for web searches. | | | OPENAI_API_KEY | String | optional if custom models provided | For OpenAI model access. | | | DEEPINFRA_API_KEY | String | optional if custom models provided | For DeepInfra model access. |

🧩 How It Works

1️⃣ Research Planning & Analysis

• Creates a DeepResearch instance with user-provided configuration
• Analyzes the input prompt to understand requirements
• Generates a comprehensive research plan
• Breaks down into focused sub-queries using LLMs

2️⃣ Data Collection & Processing

• Executes AI-powered web searches for each sub-query via JigsawStack API
• Gathers and validates relevant sources
• Generates context from search results
• Deduplicates URLs to ensure unique sources

3️⃣ Analysis & Synthesis

• Processes gathered information through reasoning models
• Analyzes and synthesizes the findings
• Evaluates information sufficiency
• Determines if additional research is needed
• Performs iterative research within configured depth limits if needed

4️⃣ Report Generation & Citations

• Creates comprehensive final report
• Iteratively generates content until complete
• Maps sources to reference numbers
• Generates bibliography with citations
• Formats output according to target length requirements

JigsawStack

This project is part of JigsawStack - A suite of powerful and developer friendly APIs for various use cases while keeping costs low. Sign up here for free!

🛠️ Contributing

Contributions are welcome! Please feel free to submit a PR :)