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

Built distribution (wheel)

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

Total release size: 8.4 MB

Release files / autolens-2026.11.7.1.tar.gz

Download URL autolens-2026.11.7.1.tar.gz
Size 8.0 MB
Tags Source
SHA-256 checksum
How to use checksums
5c368a96a0d942d376400723abaf212cd04859959b8923f9201549a09860e4cd
BLAKE2b-256 checksum
How to use checksums
1da6a34a397fcad320cf77d93ce990bb9ef35776f78a3c1383702a4bf750653e
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.7.1-py3-none-any.whl

Download URL autolens-2026.11.7.1-py3-none-any.whl
Size 431.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ae1027d762d1eae9803be6b6fe301421e121fe5744907f362e0d1cdfb1689d8
BLAKE2b-256 checksum
How to use checksums
41a7091e8f9cbbbbc06d1bfb9497a7d42ed3812b7fd957761362702c12b98240
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.7.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