Skip to main content

AMDockVS logo

AMDockVS

From molecules to docking results, in one workspace.

Documentation · First docking tutorial · Python API · Report an issue

AMDockVS is a desktop application and Python API for molecular docking and virtual screening. Prepare structures, explore compound libraries, run docking, and inspect poses and interactions. Following the original AMDock approach, each project keeps your molecules, settings, jobs, and results in one place.

Cite us

SCImago Journal & Country Rank

If you use AMDock or AMDockVS in your research, please cite the original paper:

Valdés-Tresanco, M.S., Valdés-Tresanco, M.E., Valiente, P.A. and Moreno E. AMDock: a versatile graphical tool for assisting molecular docking with Autodock Vina and Autodock4. Biology Direct, 2020 15, 12. https://doi.org/10.1186/s13062-020-00267-2


What you can do

Use the desktop interface for interactive work or the Python API to:

  • Prepare your molecules. Import receptors and ligands, generate 3D structures, and prepare docking inputs.
  • Shape your screening library. Filter compounds by molecular properties, cluster similar molecules, and select representatives.
  • Find where to dock. Predict candidate pockets with P2Rank or define a search box around a reference ligand.
  • Run docking. Use AutoDock Vina, QuickVina 2, gnina, AutoDock-GPU, or Uni-Dock through Docking Studio, with background job monitoring.
  • Inspect your results. Browse scores and poses, view complexes in PyMOL, and explore protein–ligand contacts in 2D.
  • Work with activity data. Train and evaluate QSAR models, then predict activities for other compounds.

Docking Studio with ranked poses and a selected protein–ligand complex in PyMOL

Get started

With micromamba installed:

curl -LO https://raw.githubusercontent.com/AMDockVS/AMDockVS/main/environment.yml
micromamba create -n amdockvs -f environment.yml
micromamba activate amdockvs
amdockvs

Using conda? Replace the create and activate commands with conda env create -f environment.yml and conda activate amdockvs.

On the welcome screen, choose Your first docking to work through the included Vps34-SAR405 example, from importing molecules to submitting a docking run. Watch the walkthrough.

Optional features and installation details

Install all optional Python dependencies, or select the features you need:

pip install "AMDockVS[all]"
# Individual extras: bblean, pockets, qsar
  • bblean: BitBIRCH clustering through its command-line tool.
  • pockets: the Java runtime used by P2Rank.
  • qsar: scikit-learn for model training and prediction.

Additional programs can be installed from Settings → External tools. Availability depends on the operating system and hardware; some docking engines require a compatible GPU. See the Docking Studio guide for program requirements.

The environment combines conda-forge and pip packages. To change its conda dependencies, edit environment.yml and recreate the environment instead of installing conda packages into it afterwards.

For an existing Python environment, pip install AMDockVS is also available. AMDockVS requires Python 3.12 or newer; Vina can be installed through the application's Programs step.

A closer look

Run docking and inspect poses

Docking Studio guide

Choose a docking engine, prepare ligands and receptors, define the search box, and launch a run in Docking Studio. Browse ranked poses alongside their 3D structures and 2D interaction diagrams.

Docking results with ranked poses, a PyMOL view, and a protein–ligand interaction diagram

Explore chemical diversity

Diversity guide

Group similar compounds, inspect their distribution, and choose representatives for your next screening run.

Diversity clustering with representative compounds and a chemical-space plot

Connect structures with activity

QSAR guide

Build QSAR models from measured activities and inspect model performance, predictions, and applicability to new compounds.

QSAR model analysis with training and test metrics and an observed-versus-predicted plot

License

Released under the MIT License.

Metadata

Release files for AMDockVS 0.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for AMDockVS 0.14.0
File Size Uploaded Provenance Actions
amdockvs-0.14.0.tar.gz 2.2 MB With provenance Details for amdockvs-0.14.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for AMDockVS 0.14.0
File Interpreter ABI Platform Actions
amdockvs-0.14.0-py3-none-any.whl Python 3 none any Details for amdockvs-0.14.0-py3-none-any.whl

Total release size: 3.3 MB

Release files / amdockvs-0.14.0.tar.gz

Download URL amdockvs-0.14.0.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
e7186b598467b249924313b3038265a678739192923ee8d21b91f4074b818fe8
BLAKE2b-256 checksum
How to use checksums
008c0fa980d585528afecfea5d8a8deca99111156093f3ec5d72fc2eea2cad30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / amdockvs-0.14.0-py3-none-any.whl

Download URL amdockvs-0.14.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
e86a789cac5e4c2530b94db97dca570fe7712775eeca85e1a5bcd17b22be02e9
BLAKE2b-256 checksum
How to use checksums
335a37cddc2687331a66d6f754636e9cc8c529d772dc23f0baf2d20d7a209d56
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for AMDockVS 0.14.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for amdockvs-0.14.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page