SciD-QuESt: From Scientific Documents to Knowledge

An AI-assisted React library for structured research-paper analysis workflows.

ScidQuest provides a reusable UI and workflow foundation for extracting structured information from research papers (PDF) with template-driven forms, model-assisted suggestions, and answer verification.

Table of Contents

• SciD-QuESt: From Scientific Documents to Knowledge
  • Table of Contents
  • About
  • Key Features
  • Installation
  • Quick Start
  • Configuration
  • Peer Dependencies
  • Development
  • Project Structure
  • License

About

ScidQuest is distributed as an npm package: @orkg/scidquest.

It is intended for teams building research tooling that requires:

• PDF-first review workflows
• structured questionnaire-based extraction
• AI-assisted response generation and verification
• portable frontend integration with modern React stacks

(back to top)

Key Features

• PDF upload and viewing with zoom and page navigation
• Split-panel analysis UI for side-by-side document and questionnaire usage
• Template-driven forms for consistent data extraction
• AI suggestions for draft answers from document context
• AI verification to validate user answers against source content
• Local persistence for in-progress analysis sessions
• Multi-provider model support (OpenAI, Groq, Mistral)

(back to top)

Installation

Install the package with npm:

npm install @orkg/scidquest

Import the published stylesheet in your application entrypoint:

import "@orkg/scidquest/dist/contribute-standalone.css";

(back to top)

Quick Start

Basic package usage:

import React from "react";
import { createRoot } from "react-dom/client";
import "@orkg/scidquest/dist/contribute-standalone.css";
import App from "./App";

createRoot(document.getElementById("root")!).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
);

Typical end-user workflow inside ScidQuest:

1. Upload a PDF file (up to 30 MB).
2. Complete template questions.
3. Request AI suggestions where needed.
4. Verify responses against the source document.
5. Export/import progress.

(back to top)

Configuration

Create a local environment file:

cp .env.example .env

Configure provider keys in .env (or through the UI):

• OpenAI
• Groq
• Mistral

(back to top)

Peer Dependencies

ScidQuest expects the following peer dependencies in the host project:

• react ^18.3.1
• react-dom ^18.3.1
• @mui/material ^6.4.11
• @emotion/react ^11.14.0
• @emotion/styled ^11.14.0

(back to top)

Development

Run the package locally:

npm install
npm run dev

Build distributable artifacts:

npm run build

Preview the production build:

npm run preview

(back to top)

Project Structure

ScidQuest/
├── src/
│   ├── pages/              # Page-level views
│   ├── components/         # Reusable UI components
│   ├── services/           # AI/provider and backend integrations
│   ├── utils/              # Shared utility helpers
│   ├── templates/          # Questionnaire templates
│   ├── store/              # Application state management
│   ├── context/            # React context providers
│   ├── App.tsx             # Root application component
│   ├── Router.tsx          # Routing configuration
│   └── main.tsx            # Application entrypoint
├── index.html
├── package.json
├── tsconfig.json
└── vite.config.ts

(back to top)

License

This project is released under the MIT License.