HubLensDeep Learningbytedance/jaqmc
// archived 2026-04-27
bytedance

jaqmc

AI#JAX#Quantum Monte Carlo#Deep Learning#Physics#Scientific Computing
View on GitHub
108

// summary

JaQMC is a modular, JAX-based framework designed for performing neural network quantum Monte Carlo simulations. It utilizes deep neural networks as variational wavefunctions to solve the electronic Schrödinger equation without relying on traditional basis sets. The project supports various quantum systems, including molecules, solids, and fractional quantum Hall states, through a highly configurable and extensible architecture.

// technical analysis

JaQMC is a JAX-based framework designed for neural network quantum Monte Carlo simulations, enabling the solution of the electronic Schrödinger equation using deep neural networks as variational wavefunctions. By leveraging JAX, the project provides automatic differentiation, JIT compilation, and multi-device parallelism to achieve high accuracy without the limitations of traditional basis sets. Its modular architecture allows researchers to independently swap wavefunctions, samplers, and optimizers, making it a flexible tool for modeling diverse quantum systems including molecules, solids, and fractional quantum Hall states.

// key highlights

01
Modular design allows users to independently swap components like wavefunctions, samplers, and optimizers without rewriting the entire codebase.
02
Built on JAX to provide high-performance features such as automatic differentiation, JIT compilation, and native multi-device parallelism.
03
Supports a wide range of quantum systems including atoms, molecules, solid-state materials, and fractional quantum Hall (FQHE) systems.
04
Includes pre-implemented advanced architectures like FermiNet and PsiFormer, alongside robust optimizers such as KFAC, SR, and Adam.
05
Provides a command-line interface for running simulations and adjusting hyperparameters, while maintaining full programmatic control for custom workflows.

// use cases

01
Solving the electronic Schrödinger equation for atoms, molecules, and solid-state systems
02
Implementing advanced neural network architectures like FermiNet and PsiFormer for quantum simulations
03
Leveraging JAX for automatic differentiation, JIT compilation, and multi-device parallel quantum computing

// getting started

To begin, clone the repository and install the dependencies using uv or pip with the provided configuration files. Once installed, you can execute simulations directly from the command line, such as running a hydrogen atom training task with 'jaqmc hydrogen-atom train'. Users can further customize these runs by passing configuration parameters through the CLI or by exploring the documentation to build custom workflows.