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. Each project keeps your molecules, settings, jobs, and results together.

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

Job execution in AMDockVS is powered by MolSuite.

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.13.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.13.0
File Size Uploaded Provenance Actions
amdockvs-0.13.0.tar.gz 2.2 MB With provenance Details for amdockvs-0.13.0.tar.gz

Built distribution (wheel)

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

Total release size: 3.3 MB

Release files / amdockvs-0.13.0.tar.gz

Download URL amdockvs-0.13.0.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
2fe979bd3df7278de2749b5f27846c0564ae1c74fb2458c94e7216a728ec9e7d
BLAKE2b-256 checksum
How to use checksums
20c184b34d8e36b628f92ca80c4b51caf95dca34f7ead35f747ac2bc01714f20
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 16, 2026.

Transparency log

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

Download URL amdockvs-0.13.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7c8b66d43a2baf6efda2eb9a4f0ae99618064985458863853c66b857a9e67213
BLAKE2b-256 checksum
How to use checksums
e1463e002a4f498e0ea703ca35d235b42ad5fe40724dd64b9a6cb78ac72202d0
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 16, 2026.

Transparency log

Security for AMDockVS 0.13.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.13.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 16, 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