whatisgithub

What is ai-computational-chemist?

jcliugroup/ai-computational-chemist — explained in plain English

Analysis updated 2026-05-18

57PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A library of instruction files that teach an AI agent to run computational chemistry calculations, check them against reviewer feedback, and draft response letters, with human approval at each step.

Mindmap

mindmap
  root((AICC))
    What it does
      Triages reviewer comments
      Runs chemistry calculations
      Drafts response letters
    Tech stack
      Python scripts
      VASP and Gaussian
      LAMMPS and pymatgen
    Use cases
      Peer review response
      DFT and MD workflows
      Multi agent research projects
    Audience
      Computational chemists
      Materials researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Triage which peer-review comments actually require new computational chemistry calculations.

USE CASE 2

Run DFT, quantum chemistry, or molecular dynamics calculations consistent with a paper's existing methods.

USE CASE 3

Draft response-letter paragraphs and supporting information tables from calculation results.

USE CASE 4

Coordinate a multi-step computational chemistry project across several AI agents with tracked task dependencies.

What is it built with?

PythonVASPGaussianLAMMPSpymatgen

How does it compare?

jcliugroup/ai-computational-chemistdexmal/opendwhexsecteam/droidhunter
Stars575757
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity5/55/54/5
Audienceresearcherresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires separately installed computational chemistry software (VASP, CP2K, Gaussian, etc.) and HPC access, this repo only supplies the agent instructions.

So what is it?

AI Computational Chemist, or AICC, is a collection of instruction files that teach an AI agent how to do computational chemistry and materials science work. It is not one program you run, it is a set of skills, written as documents an agent can read and follow, that work with tools like Claude Code, Codex, Cursor, or opencode. The main use it is built for is helping researchers respond to peer review. When a scientific paper's reviewers ask for extra calculations, an AI agent using these skills can read the manuscript and the reviewer comments, figure out which comments actually need new calculations, run those calculations using the same scientific methods the paper already used, check whether each result really answers the reviewer's concern, and then help draft the written response and supporting material. A human is expected to approve the plan before calculations start and approve the final draft before anything is sent out. If a new calculation contradicts what the original paper claimed, the process stops and flags it to the researchers instead of hiding or reframing the result. The skills also work on their own, outside the peer review use case, for general computational chemistry tasks like density functional theory, quantum chemistry, molecular dynamics, machine learning potentials, phonon calculations, and reaction kinetics modeling. For bigger projects, there is an additional layer called the research orchestrator, which tracks a whole project as a set of linked tasks with dependencies, records what has been decided and why, and keeps different tasks from stepping on each other when multiple agents are working at once. The repository is organized into three kinds of building blocks: procedures that guide multi-step work, tools that operate specific chemistry software packages like VASP, Gaussian, and LAMMPS, and a knowledge library of chemistry background material the other two can draw on.

Copy-paste prompts

Prompt 1
Use the review-response skill to triage which of these reviewer comments require new calculations for my manuscript.
Prompt 2
Walk me through setting up the research orchestrator's task DAG for a multi-step VASP project.
Prompt 3
Explain how the structure-prep and structure critic gate check a slab model before running VASP or CP2K.
Prompt 4
Show me how the phonopy skill would set up a finite-displacement phonon calculation for my structure.

Frequently asked questions

What is ai-computational-chemist?

A library of instruction files that teach an AI agent to run computational chemistry calculations, check them against reviewer feedback, and draft response letters, with human approval at each step.

What language is ai-computational-chemist written in?

Mainly Python. The stack also includes Python, VASP, Gaussian.

How hard is ai-computational-chemist to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is ai-computational-chemist for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.