Skip to main content

PyAutoLens-JAX: Open-Source Strong Lensing

Colab Documentation Status Tests Build Code Style: black JOSS Zenodo DOI arXiv Project Status: Active Python Versions PyPI Version

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.

Getting Started

Natural Language or Python

You can use PyAutoLens by describing what you want in natural language, through the PyAutoLens AI Assistant, or by writing Python yourself. Both routes use the same software. To start in natural language, paste this prompt into Claude Code, Codex or another AI coding agent:

Starting prompt for Claude Code, Codex or other AI coding agent

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 that repository,
cd into it and follow its AGENTS.md.

Begin the "start here" guide for a new user.

The assistant takes you through the Start Here page as a conversation (grids, light and mass profiles, ray-tracing, then simulating and fitting a strong lens), one step at a time, then helps you get started on your own lenses. Claude Code and Codex are recommended, and sustained scientific use normally needs paid access to one of them. Free options are listed on the AI Options page. Start Here explains why PyAutoLens is designed to be used in natural language, and why its Python API is not going anywhere.

Documentation and Examples

All of the documentation and examples are written for people to read:

Community & Contributing

PyAutoLens is built in the open by its users: everyone is welcome to ask questions, share what they have made with it, and contribute.

Questions, ideas and bug reports: the PyAutoLabs Discussions. Chat with us on Slack.

Community-built tools and tutorials, and how to contribute: the PyAutoLens community 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.

i found you, i found you, i found you beautiful, exploding, i found you

Metadata

Release files for autolens 2026.11.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autolens 2026.11.5.1
File Size Uploaded Provenance Actions
autolens-2026.11.5.1.tar.gz 8.0 MB Without provenance Details for autolens-2026.11.5.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for autolens 2026.11.5.1
File Interpreter ABI Platform Actions
autolens-2026.11.5.1-py3-none-any.whl Python 3 none any Details for autolens-2026.11.5.1-py3-none-any.whl

Total release size: 8.4 MB

Release files / autolens-2026.11.5.1.tar.gz

Download URL autolens-2026.11.5.1.tar.gz
Size 8.0 MB
Tags Source
SHA-256 checksum
How to use checksums
1e42e3957b42700252881780ff08f5f29d729f18855f61c7dc73a683cb6b4cb0
BLAKE2b-256 checksum
How to use checksums
bfa596c35df08a4811043e443d2acd3d2748a7d755dccf4fd9caa72259415668
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.12.16

Release files / autolens-2026.11.5.1-py3-none-any.whl

Download URL autolens-2026.11.5.1-py3-none-any.whl
Size 431.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
69bb71bd87eb60c0fa8e57d1fdde7452ea7e5e0124b06b999b212c113736d4da
BLAKE2b-256 checksum
How to use checksums
45475bc672595e00952dbc89ba41d0911d8eebf83ceb27456ed623bb85660641
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.12.16

Security for autolens 2026.11.5.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page