PyAutoLens-JAX: Open-Source Strong Lensing
Installation Guide | readthedocs | Introduction on Colab | HowToLens
When two or more galaxies are aligned perfectly down our line-of-sight, the background galaxy appears multiple times.
This is called strong gravitational lensing and PyAutoLens makes it simple to model strong gravitational lenses, using JAX to accelerate lens modeling on GPUs.
🤖 AI-assisted use: you can also learn and drive PyAutoLens with AI — either a browser chat assistant (ChatGPT, Claude) pointed at autolens_assistant, or a fully agentic coding tool (Claude Code, Codex) that runs lens modeling end-to-end on your machine. See the Three Ways to Learn PyAutoLens section below.
Getting Started
The following links are useful for new starters:
- The PyAutoLens readthedocs: which includes an overview of PyAutoLens's core features, a new user starting guide and an installation guide.
- The introduction Jupyter Notebook on Google Colab: try PyAutoLens in a web browser (without installation).
- The autolens_workspace GitHub repository: example scripts covering every PyAutoLens use case.
- The HowToLens GitHub repository: a Jupyter notebook lecture series teaching strong lensing and lens modeling from the ground up.
Three Ways to Learn PyAutoLens
There are three ways to learn how to use PyAutoLens, which you can freely mix and match:
- Manual navigation — read the workspace guides yourself, starting from the new user guide and the
start_herenotebooks, which are organised by lens scale and dataset type. - AI chat assistant — ask questions to a conversational AI assistant such as ChatGPT or Claude in the browser. Go to the autolens_assistant repository and copy the ready-to-use example prompt from its README into ChatGPT or Claude to get started. This is ideal for learning the API, working out how to perform a calculation, and creating end-to-end example Python scripts.
- Fully agentic AI — drive PyAutoLens end-to-end with an agentic coding tool such as Claude Code or Codex together with autolens_assistant. These can inspect your data, write and run scripts, and manage a lens-modeling project directly on your machine.
See autolens_assistant for more on the AI-assisted options (2 and 3).
Community & Support
Support for PyAutoLens is available via our Slack workspace, where the community shares updates, discusses gravitational lensing analysis, and helps troubleshoot problems.
Slack is invitation-only. If you'd like to join, please send an email requesting an invite.
For installation issues, bug reports, or feature requests, please raise an issue on the GitHub issues page.
HowToLens
For users less familiar with gravitational lensing, Bayesian inference and scientific analysis you may wish to read through the HowToLens lectures. These teach you the basic principles of gravitational lensing and Bayesian inference, with the content pitched at undergraduate level and above.
A complete overview of the lectures is provided on the HowToLens readthedocs page, and the notebooks themselves live in the PyAutoLabs/HowToLens repository.
Citations
Information on how to cite PyAutoLens in publications can be found on the citations page.
Contributing
Information on how to contribute to PyAutoLens can be found on the contributing page.
Hands on support for contributions is available via our Slack workspace, again please email to request an invite.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file autolens-2026.7.22.1.tar.gz.
File metadata
- Download URL: autolens-2026.7.22.1.tar.gz
- Upload date:
- Size: 6.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.0.1 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b67288f4e114e25b770cde77f9f0d9c4011dfdf53cf801bf22869e6c84adab60
|
|
| MD5 |
1b1dad6b2c953034725e192374bb6bad
|
|
| BLAKE2b-256 |
927cf027514178924ff62ae835c2e4a0775bd8bc54da92c9f31736a885c447b3
|
File details
Details for the file autolens-2026.7.22.1-py3-none-any.whl.
File metadata
- Download URL: autolens-2026.7.22.1-py3-none-any.whl
- Upload date:
- Size: 6.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.0.1 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
125e9dcb7748c53dd65103400f260c02992d439b7fcd328cef74eb062b899d5c
|
|
| MD5 |
b6b24a04a7e67df33a043f13fe987c7a
|
|
| BLAKE2b-256 |
a802418c64c1db4f903099f091003dd78e2688a108eb1024940fb7ddc5c82827
|
