Skip to content

Repository files navigation

quantum.harness

Note This harness system is in an early stage and evolving fast. Harnessing Quantum 2026 participants: this is the repository you work in and send your pull request to — start with Start Here below. A formal release is planned for August 2026.

A computational quantum research harness. It helps an AI agent to run the simulation of quantum systems. Each method is curated by world-leading experts in that computational approach, so the guidance reflects real research practice: what to compute, which checks matter, and where common failures happen.

The Harness provides:

  • Model cards with Hamiltonians, symmetries, etc
  • Numeric methods and tool-usage skills with parameters setup guidance, computational resource estimation, and verification checks.
  • Supporting skills for research survey, report writing, paper reproduction.
  • Cluster support for calculations too large for a laptop.
harness-c

Start Here

If you do not yet have Claude Code, Codex CLI, or OpenCode installed, follow the summer-school agent setup guide first.

Paste this into Claude Code, Codex, or OpenCode:

Clone https://github.com/QuantumBFS/quantum.harness.
Run `/onboard` and `make skills` to install necessary dependencies.
Then run `/beginner-training` skill to start the guided training.

Numeric Methods for Quantum Systems

Each method is curated by world-leading experts in that computational approach.

Method Expert contributor Skill
Exact diagonalization Chen Cheng (程晨) /method-ed
MPS / LTRG / DMRG / TEBD Wei Li (李伟) /method-mps · /method-ltrg
PEPS / CTMRG Hai-Jun Liao (廖海军), Shenghan Jiang (姜胜寒) /method-peps
Quantum Monte Carlo Ming-Pu Qin (秦明普), Zi Hong Liu (刘子宏) /method-qmc
Quantum circuit simulation Shi-Xin Zhang (张士欣) /method-qcs
Semidefinite programming Jie Wang (王杰) /method-polyopt
AI agent and knowledge base Kun Chen (陈锟), Jin-Guo Liu (刘金国) tracks/agent-kb

Example Prompts

I want to reproduce Figure 2 of arXiv:1711.03528,
the PXP quantum many-body scars paper.
Use /reproduce-paper to guide me.
/solve ground state of the J1-J2 Heisenberg model
on a 6x6 square lattice at J2/J1=0.5
Survey recent work on neural quantum states
for frustrated magnets.
Use /survey to build a reference library.

More

  • .knowledge/ - model, physics, method, benchmark, and literature cards.
  • skills/ - agent workflows invoked as /name.
  • Harnessing Quantum 2026 submission guide - for summer-school participants: English · 中文.
  • AGENTS.md - full harness operating instructions.