Metadata-Version: 2.4
Name: AMDockVS
Version: 0.14.1
Summary: AMDock - chemistry-focused virtual screening and docking desktop app built on the MolSuite orchestrator.
Author: Mario S. Valdés-Tresanco, Mario E. Valdés-Tresanco, Ernesto Moreno, Pedro A. Valiente
License-Expression: MIT
Project-URL: Homepage, https://github.com/AMDockVS/AMDockVS
Project-URL: Documentation, https://amdockvs.github.io/
Project-URL: Issues, https://github.com/AMDockVS/AMDockVS/issues
Keywords: docking,virtual-screening,autodock-vina,cheminformatics,molsuite,structural-biology
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Environment :: X11 Applications :: Qt
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ms_env>=0.4.3
Requires-Dist: ms_flow>=0.12.0
Requires-Dist: ms_components[monitor,projects,pymol,steps,table]>=0.7.2
Requires-Dist: ms_contactmap>=0.3.4
Requires-Dist: rdkit>=2025.3.5
Requires-Dist: dimorphite-dl<3,>=2.1.0
Requires-Dist: ms_adtools>=0.2
Requires-Dist: gemmi>=0.6
Requires-Dist: numpy>=2.0.0
Requires-Dist: scipy>=1.15
Requires-Dist: pandas>=2.3.1
Requires-Dist: pyarrow>=15
Requires-Dist: pydantic>=2.0
Requires-Dist: tqdm>=4.66
Requires-Dist: joblib>=1.3
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: sqlmodel>=0.0.24
Requires-Dist: PySide6>=6.5
Requires-Dist: pyqtgraph>=0.13
Provides-Extra: bblean
Requires-Dist: bblean>=0.10; extra == "bblean"
Provides-Extra: pockets
Requires-Dist: jdk4py>=21; extra == "pockets"
Provides-Extra: qsar
Requires-Dist: scikit-learn>=1.5; extra == "qsar"
Provides-Extra: all
Requires-Dist: amdockvs[bblean,pockets,qsar]; extra == "all"
Dynamic: license-file

<p align="center">
  <img src="src/amdockvs/ui/resources/icons/logo.svg" width="80" alt="AMDockVS logo">
</p>
<h1 align="center">AMDockVS</h1>

<p align="center"><strong>From molecules to docking results, in one workspace.</strong></p>

<p align="center">
  <a href="https://amdockvs.github.io/AMDockVS/latest/">Documentation</a> ·
  <a href="https://amdockvs.github.io/AMDockVS/latest/overview/#tutorial">First docking tutorial</a> ·
  <a href="https://amdockvs.github.io/AMDockVS/latest/runtime_api/">Python API</a> ·
  <a href="https://github.com/AMDockVS/AMDockVS/issues">Report an issue</a>
</p>

<p align="justify">
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
<a href="https://doi.org/10.1186/s13062-020-00267-2">AMDock</a> approach, each project
keeps your molecules, settings, jobs, and results in one place.
</p>

## Cite us

<a href="https://www.scimagojr.com/journalsearch.php?q=5800173376&amp;tip=sid&amp;clean=0" title="SCImago Journal &amp; Country Rank"><img border="0" align="right" src="https://www.scimagojr.com/journal_img.php?id=5800173376" alt="SCImago Journal &amp; Country Rank" /></a>

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](https://doi.org/10.1186/s13062-020-00267-2)

<br clear="right">

## What you can do

Use the desktop interface for interactive work or the
[Python API](https://amdockvs.github.io/AMDockVS/latest/runtime_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](docs/images/AMDockVS_docking_studio_results.png)

## Get started

With [micromamba](https://mamba.readthedocs.io/en/latest/installation/micromamba-installation.html#linux-and-macos)
installed:

```bash
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](https://www.youtube.com/watch?v=HjT4PxUy0yg).

<details>
<summary>Optional features and installation details</summary>

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

```bash
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](https://amdockvs.github.io/AMDockVS/latest/docking_studio/) 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.

</details>

## A closer look

### Run docking and inspect poses

[Docking Studio guide](https://amdockvs.github.io/AMDockVS/latest/docking_studio/)

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](docs/images/AMDockVS_2D_interactions.png)

### Explore chemical diversity

[Diversity guide](https://amdockvs.github.io/AMDockVS/latest/diversity/)

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

![Diversity clustering with representative compounds and a chemical-space plot](docs/images/AMDockVS_diversity_cluster.png)

### Connect structures with activity

[QSAR guide](https://amdockvs.github.io/AMDockVS/latest/qsar/)

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](docs/images/AMDockVS_QSAR_workflow_Analysis1.png)

## License

Released under the [MIT License](https://github.com/AMDockVS/AMDockVS/blob/main/LICENSE).
