AutoLEI installation
====================

Supported environment
---------------------

- Linux or Windows through WSL
- Python 3.9-3.14 for the AutoLEI 1.0 release line
- XDS is required for processing; XDSGUI and SHELX tools are optional

Standard Python installation
----------------------------

Create and activate a virtual environment, then run:

    python -m pip install --upgrade pip
    python -m pip install autolei
    python -m pip check
    python -m autolei --version
    autolei-doctor

Managed Linux/WSL installation
------------------------------

From an AutoLEI source checkout, run:

    bash install_script/linux.sh

The installer creates an isolated environment, installs the Python package and
XDS stack, verifies required dependencies, and runs AutoLEI diagnostics. It
returns a non-zero status when a required step fails.

Useful commands
---------------

    autolei                         Launch the GUI
    python -m autolei               Launch the GUI through Python
    autolei-setting --path          Print the writable settings path
    autolei-add-instrument FILE     Install a custom instrument profile
    autolei-doctor                  Check required and optional tools

User settings and custom instrument profiles are outside site-packages and are
preserved when AutoLEI is upgraded.

