deepmd-python-inference

Load DeePMD-kit models in Python to predict energy, forces, and virial.

124|25|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/jinzhezenggroup/computational-chemistry-agent-skills --skill deepmd-python-inference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepmd-python-inference
Source: https://github.com/jinzhezenggroup/computational-chemistry-agent-skills/tree/main/machine-learning-potentials/deepmd-python-inference
Command: npx skills add https://github.com/jinzhezenggroup/computational-chemistry-agent-skills --skill deepmd-python-inference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Load a trained DeePMD-kit model in Python and perform fast predictions of energy, forces, and virial for atomic configurations. It also covers descriptor evaluation and cross-model comparison using the DeepPot API, plus CLI tools for batch testing.

Core Features & Use Cases

  • Inference: load PyTorch (.pth) or TensorFlow (.pb) models, or built-in pretrained models, and obtain energy, forces, and virial.
  • Descriptor evaluation: compute atomic environment descriptors from configurations.
  • Model comparison: compute model deviation across multiple models; batch evaluation for datasets.
  • CLI testing: run dp test-like workflows for labeled data and benchmarking.

Quick Start

Run a Python script to load a trained or pretrained DeePMD-kit model and perform a simple inference on a sample configuration.

Frequently Asked Questions about deepmd-python-inference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run DeePMD-kit model inference in Python to predict energy and forces?

DeePMD-kit model inference in Python uses the DeepPot API to load trained or pretrained models and predict energy, forces, and virial. You can execute predictions on single frames or batches directly within your Python scripts.

Can I load both PyTorch and TensorFlow DeePMD-kit models for inference?

Yes, DeePMD-kit inference supports loading both PyTorch (.pth) and TensorFlow (.pb) trained models, as well as built-in pretrained models. The DeepPot API handles the loading process to compute energy, forces, and virial.

What is model deviation analysis in DeePMD-kit and when do I need it?

Model deviation analysis in DeePMD-kit computes prediction differences across multiple saved models. It is needed when comparing model performance or evaluating prediction uncertainty for atomic configurations during batch dataset testing.

Does DeePMD-kit Python inference support descriptor evaluation for atomic environments?

Yes, DeePMD-kit Python inference supports descriptor evaluation to compute atomic environment descriptors from configurations. This runs alongside energy and force predictions using the DeepPot API on CPU or GPU backends.

Do I need the deepmd-kit Python package installed to run model inference?

Yes, installing the deepmd-kit Python package is required to run model inference, descriptor evaluation, and model deviation analysis. The package enables the DeepPot API and CLI testing workflows on CPU or GPU backends.

What's the best way to perform batch DeePMD-kit inference on labeled datasets?

For batch DeePMD-kit inference on labeled datasets, use the CLI testing workflows that replicate dp test-like functionalities. This allows efficient benchmarking and batch evaluation of energy and force predictions across multiple frames.