.. figure:: _static/logo.jpg
   :alt: AESP
   :align: center

Welcome to AESP's documentation!
#################################

**AESP**  (Adaptive Evolutionary Structure Predictor) is a robust, open-source Python library 
for Crystal Structure Prediction. AESP is dedicated to quick and easy operations, so that people 
can get the results they want without taking too much time.

.. note::

   The AESP is under active development.

Latest version
--------------

AESP v2025.10.1


Contributors
------------

C.L. Qin (clqin@foxmail.com)


.. toctree::
   :maxdepth: 3
   :numbered:
   :caption: Basic Guide
   
   introduction
   install
   quick_start

.. toctree::
   :maxdepth: 3
   :numbered:
   :caption: Advanced Guide

   background
   quick_cli
   cli
   input_script
   input_args
   outputs
   gui

.. toctree::
   :maxdepth: 3
   :numbered:
   :caption: Examples

   examples/emt_mg_3d_local
   examples/matgl_alcl_3d_local

.. toctree::
   :maxdepth: 3
   :numbered:
   :caption: Citations & Publications 

   citations
   publications