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.6.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.6.1
File Size Uploaded Provenance Actions
autolens-2026.11.6.1.tar.gz 8.0 MB Without provenance Details for autolens-2026.11.6.1.tar.gz

Built distribution (wheel)

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

Total release size: 8.4 MB

Release files / autolens-2026.11.6.1.tar.gz

Download URL autolens-2026.11.6.1.tar.gz
Size 8.0 MB
Tags Source
SHA-256 checksum
How to use checksums
7ae76c5b12a6a9162f40ad7d38d94b3c85a73faec89d2aded4aee75d77aa796f
BLAKE2b-256 checksum
How to use checksums
b9cf62040114210f6a8885bec52a33561b60ad857580d6060c25fab42fef740a
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.6.1-py3-none-any.whl

Download URL autolens-2026.11.6.1-py3-none-any.whl
Size 431.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6f1479048163342af4906305883a5d3c6cc28860bb3f75cfcbf0fa16dac3a286
BLAKE2b-256 checksum
How to use checksums
7c40816b703107513b6f888ddc62532dc898a0f0fa0f743726e784ebf0018fd9
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.6.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