Research Wizard Logo

Your all-in-one desktop workspace for research management, literature discovery, and AI-powered drafting.

---

Research Wizard is a modern desktop application that streamlines the entire research workflow. Manage projects, discover literature, and draft reports with the help of advanced AI agents—all in a unified, customizable workspace.

---

• Project Management: Create, organize, and edit research projects with metadata, keywords, and research questions. AI-assisted keyword/question generation.
• Literature Discovery & Management:
  • Search and import papers from top research databases (see Integrations below).
  • Annotate, organize, and manage literature per project.
• AI-Powered Drafting:
  • Generate outlines and full drafts using leading AI models (Gemini, OpenAI, Claude).
  • Both manual and AI-assisted drafting supported.
• Customizable Report Generation:
  • Generate, edit, and export research reports in Markdown, DOCX, or PDF.
  • Fine-tune report parameters and structure.
• Settings & Integrations:
  • Configure AI agents and literature retrievers, manage API keys, and set user/language preferences.
  • Modular and extensible for new integrations.
• Internationalization:
  • UI supports multiple languages and RTL/LTR layouts.
• Modern UI/UX:
  • Built with reusable, accessible components and a clean, responsive design.

---

• Gemini (Google AI) — default
• OpenAI
• Claude (Anthropic)

• Exa (AI-based, free-tier available)
• Crossref
• DBLP
• PLOS
• OpenAlex
• EuropePMC
• CoreAPI
• Elsevier
• NCBI-NIH
• arXiv
• Semantic Scholar

Each retriever/agent can be enabled, configured, or extended via the Settings panel.

---

• Frontend: React + TypeScript, modular component system, hooks, and context for state management.
• Backend: Node.js/TypeScript, modular clients for AI and literature APIs, extensible retriever/agent system.
• IPC Connectors: Seamless communication between frontend and backend for data, AI, and search operations.
• Internationalization: Built-in i18n with support for multiple languages and RTL/LTR layouts.

---

1. Clone the repository:

   git clone https://github.com/alaaet/research_wizard.git
   cd research_wizard

2. Install dependencies:

   # For example, if using npm
   npm install

3. Run the app:

   npm start

   Or follow the detailed installation guide for your OS.

---

• Add New AI Agents or Retrievers:
  • Extend the backend by adding new modules in backend/ai_client/agents or backend/search_client/retrievers.
  • Register new agents/retrievers in the settings JSON files.
• UI Customization:
  • Modify or add React components in src/components.
• Internationalization:
  • Add new languages in src/locales.

---

• Code Structure:
  • src/ — Frontend (React, UI, hooks, pages)
  • backend/ — Backend (API clients, search, AI, utilities)
• API Keys:
  • Store your API keys for AI agents and retrievers in the Settings panel or as environment variables.
• Contribution Guide:
  • See CONTRIBUTING.md for how to get started.

---

• Official Documentation & Guides

---

We welcome contributions! Please read our contribution guidelines and open an issue or pull request.

---

• Icons from LobeHub
• Built with ❤️ for the research community
• Code was partially created by Lovable
• Cursor contributed to some specific implementations