Skip to content

Latest commit

 

History

History
95 lines (59 loc) · 4.49 KB

File metadata and controls

95 lines (59 loc) · 4.49 KB

Checklist Reviewer Toolkit

A toolkit for evidence-backed agentic assessment of scientific papers against structured checklists -- combining data collection, review processes, human verification, and analysis.

Overview (toolkit purpose, components, demo):
https://materials-data-science-and-informatics.github.io/checklist_reviewer/

On the webpage we explain what the project is about (scaling publications vs. manual review; trade-offs of pure LLM vs. agentic workflows), and describe the four pipeline stages, the dynamic process designer (node-based workflows, agents as composable tools, transparency and explainability), and key capabilities: choice of backbone models (e.g. local Ollama, remote Google GenAI, LiteLLM), external tools for claim verification and integrations, and a modular plug-and-play architecture. It also highlights presentation at the HMC Conference 2026.

This repository contains the runnable web application and review workflow implementation you can run locally.


Authors

Hamed Hemati · Alicia Janz · Stefan Sandfeld

Institute for Materials Data Science and Informatics (IAS-9), Forschungszentrum Jülich


Repository structure

Folder / file Purpose
src/web/ Flask web application: UI modules (collections, checklist review, analysis, human verification, settings, workspace) including templates and static assets.
src/review_workflow/ The LLM pipeline: engines and components for pre-processing, evaluating (agents/tools), and post-processing papers.
src/core/ Foundational logic and tools: storage, task management, PDF processing, embeddings, and workspace management.
workspaces/ All user data (gitignored). Contains user profiles (e.g. guest/) with their collections, checklists, process definitions, and configs.
app.py Entry point: creates the Flask app and runs the dev server.

How to run

Python 3.11+ required.

Option 1: uv (no manual install)

uv run app.py

uv creates a .venv and installs dependencies from pyproject.toml. The app is served at http://127.0.0.1:5555.

Option 2: pip

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python app.py

App runs at http://127.0.0.1:5555.


License

This project is licensed under the MIT License. See the LICENSE file for details.


Acknowledgments

This toolkit is developed at the Institute for Materials Data Science and Informatics (IAS-9) of Forschungszentrum Jülich as part of the DKZ.2R project.

DKZ.2R is the Rhine-Ruhr Center for Scientific Data Literacy and one of Germany’s eleven data literacy centers. Further information: dkz2r.de.

Institute for Materials Data Science and Informatics (IAS-9) Forschungszentrum Jülich DKZ.2R – Rhine-Ruhr Center for Scientific Data Literacy

Contributing

Contributions are welcome. Please fork the repository and open a pull request with your changes.

For questions or issues, please open an issue in this GitHub repository.