Metadata-Version: 2.4
Name: autolens
Version: 2026.11.13.1
Summary: Open-Source Strong Lensing
Author-email: James Nightingale <James.Nightingale@newcastle.ac.uk>, Richard Hayes <richard@rghsoftware.co.uk>
License: MIT
Project-URL: Homepage, https://github.com/PyAutoLabs/PyAutoLens
Keywords: cli
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: autonerves>=2026.11.9.1.post1
Requires-Dist: autogalaxy>=2026.8.22.1
Requires-Dist: nautilus-sampler==1.0.5
Provides-Extra: jax
Provides-Extra: coolest
Requires-Dist: coolest; extra == "coolest"
Provides-Extra: optional
Requires-Dist: autolens[jax]; extra == "optional"
Requires-Dist: coolest; extra == "optional"
Requires-Dist: numba; extra == "optional"
Requires-Dist: zeus-mcmc==2.5.4; extra == "optional"
Requires-Dist: getdist==1.4; extra == "optional"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: sphinx_copybutton; extra == "docs"
Requires-Dist: sphinx_design; extra == "docs"
Requires-Dist: sphinx_inline_tabs; extra == "docs"
Requires-Dist: sphinx_autodoc_typehints; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: coolest; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: coolest; extra == "dev"
Dynamic: license-file

# PyAutoLens: Automated, Autodifferentiable and Autonomous Gravitational Lensing

<img src="https://github.com/Jammy2211/PyAutoLogo/blob/main/gifs/pyautolens.gif?raw=true" width="900" />

**PyAutoLens** models strong gravitational lenses to measure the distribution of matter and reconstruct distant galaxies. Its JAX numerical backend provides automatic differentiation and GPU acceleration, while the PyAutoLens Assistant helps you develop and run analyses through conversation.

## Getting Started

### Explore It Yourself

- **[Start Here](https://pyautolens.readthedocs.io/en/latest/overview/overview_1_start_here.html)** — discover PyAutoLens and work through your first example.
- **[Try it in your browser](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.11.12.1/start_here.ipynb)** — run the introductory notebook without installing anything.
- **[Install PyAutoLens](https://pyautolens.readthedocs.io/en/latest/installation/overview.html)** — get set up on your computer.

Visit the [workspace](https://github.com/PyAutoLabs/autolens_workspace#find-your-examples) to find examples for your data and science goals.

### Explore with AI

The [**PyAutoLens AI Assistant**](https://github.com/PyAutoLabs/autolens_assistant) helps you learn lensing, run examples and analyse your own data through conversation. To get started, paste this prompt into your AI coding agent:

```text
I want to do strong lensing science with PyAutoLens
(https://github.com/PyAutoLabs/PyAutoLens) and the
autolens_assistant (https://github.com/PyAutoLabs/autolens_assistant).

First clone the assistant repository, cd into it and follow its AGENTS.md.
Begin the "start here" guide for a new user.
```

See [AI Options](https://github.com/PyAutoLabs/PyAutoScientist/blob/main/AI_OPTIONS.md) for tools and setup guidance.

## Learn Lensing

[**HowToLens**](https://github.com/PyAutoLabs/HowToLens) teaches gravitational lensing and Bayesian inference through worked notebooks, starting from undergraduate level.

The [PyAutoLens documentation](https://pyautolens.readthedocs.io/en/latest/index.html) covers the software’s features and how to use them in your own analysis.

## Community and Contributing

Ask questions, suggest improvements and share your work in [PyAutoLabs Discussions](https://github.com/orgs/PyAutoLabs/discussions), or chat with us on [Slack](https://join.slack.com/t/pyautolens/shared_invite/zt-2cufp4eyf-fXfgMxRGuvg~bMrI3uOAxg).

To contribute or explore community projects, visit the [PyAutoLens community page](https://pyautolens.readthedocs.io/en/latest/general/community.html).

## Project Resources

Find the [PyPI package](https://pypi.org/project/autolens/), check [test runs](https://github.com/PyAutoLabs/PyAutoLens/actions) and [release builds](https://github.com/PyAutoLabs/PyAutoHands/actions), or access the [archived software release](https://doi.org/10.5281/zenodo.4548697).

## Citations

If you use PyAutoLens in your research, see the [citation guide](https://github.com/PyAutoLabs/PyAutoLens/blob/main/CITATIONS.md).

## License

See the [license](https://github.com/PyAutoLabs/PyAutoLens/blob/main/LICENSE).

<!-- Preserve this deliberately chosen song footer during README rewrites. -->
<sub><i><a href="https://open.spotify.com/track/6Ao5d7TMQ92h87jQqSHGyw">i found you beautiful, exploding, i found you</a></i></sub>
