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.1

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

Built distribution (wheel)

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

Total release size: 3.3 MB

Release files / amdockvs-0.14.1.tar.gz

Download URL amdockvs-0.14.1.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
994a69d394203991038befeabd8b384dd1410799a5cfcb8ca0341338a1286350
BLAKE2b-256 checksum
How to use checksums
5c53347637beb6b840f0d0ad4f10d16f0d35c8e443d5e0ecf425210021f1cf2e
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.1-py3-none-any.whl

Download URL amdockvs-0.14.1-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ad9cc6901efeb25535686220a691945fa67cbad94e9c2c5a9e3093ee7c0f5d10
BLAKE2b-256 checksum
How to use checksums
2ee9068e14857908543993981308ac6b302565ccf9b3a0aba27cd50bf09bea22
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.1

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.1.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