Skip to main content

BasedPL

BasedPL, the Based-array Programming Language, is an array language derived from APL, with ideas from J and BQN. Its notation aims to be simple and consistent. Most of this documentation calls it BPL. BPL is written in Rust and comes as a native executable, a Jupyter kernel and a Python API.

LLMs: read llms.txt first. It is the primary reference index and concise overview. In a BPL session, ]help llms shows the same file.

Install and try it

pip install basedpl
basedpl-install
bpl

basedpl-install installs the Jupyter kernel and BPL fonts for your user. On macOS it also installs a native keyboard layout.

Each release also has a standalone bpl that needs no Python, for macOS on Apple silicon and for Linux on x86-64 and arm64. On a Mac:

curl -Lo bpl https://github.com/AnswerDotAI/basedpl/releases/latest/download/bpl-macos-arm64
chmod +x bpl

On Linux, download bpl-linux-x86_64 or bpl-linux-arm64 instead.

At the prompt, define a mean and apply it:

avg←+/÷≢
avg 2 4 9
5

To run the same example from a shell, use bpl -e 'avg←+/÷≢ ◇ avg 2 4 9'. The command-line guide covers source files and pipes.

Interactive use

In the REPL, type a backtick followed by a glyph name. For example, `iota becomes ι when you press Tab or type a non-letter. Abbreviations and Alt-key shortcuts are available. ]help + shows help for +. •prefs changes display settings, such as boxes and how much of a large array is shown. See REPL and the glyph reference, which lists each glyph’s key.

In Jupyter, select the installed BasedPL kernel. Cells share definitions and support completion, Shift-Tab help and interruption. You can also use %%bpl cells in a Python notebook. See Using BPL notebooks.

New to APL?

APL is a language built around operations on whole arrays and notation for combining functions. Here is a taste of that style in BPL.

Numbers separated by spaces form a vector. Arithmetic applies to every item:

10+1 2 3
11 12 13

Operators modify or combine functions. / turns addition into summation. ι10 generates 0…9:

+/ι10
45

Functions can also be combined without naming their arguments. In avg←+/÷≢, the mean is defined as the sum (+/) divided by the tally (≢):

avg 1 2 3 4
2.5

To see how these ideas express an algorithm, start from “a prime has exactly two positive divisors”. Calculate the remainders for every pair of numbers from 1 to 50 (|⊗⍨↦50ₓ), count the zeros down each column (+⌿0ₓ=), and find the positions (⍸) whose count is two. Positions count from 0. ≥ increments each position to recover its number:

≥⍸2ₓ=+⌿0ₓ=|⊗⍨↦50ₓ
[2 3 5 7 11 13 17 19 23 29 31 37 41 43 47]ₓ

Getting started builds a primes function from the same divisor count, step by step, and displays the divisibility matrix along the way.

What’s distinctive?

For APL users, some key differences are:

  • Based arrays, as in BQN: numbers, characters and functions are atoms; enclosure always adds a layer.
  • Vectors in brackets, and grouping by spaces. [a b c] is a vector, and a+b × c+d is (a+b)×(c+d). A run that ends in a function is a train. For example, +/÷≢ x is the mean of x, and 2× doubles its argument. 0⌷v and v₀ both select the first item of v.
  • Leading-axis broadcasting, including expansion of length-1 axes, plus string keys and names on axes.
  • Exact integers and rationals alongside approximate real and complex numbers.
  • Dfns, trains and operators, with additions such as Under, iteration histories, windows and function arrays.

Positions and axes count from 0, as in BQN and Python. Default Mathish mode uses relative tolerance 1E¯14 for 64-bit comparisons and defines 0÷0=0 for Mathish types. See the language principles for the language design, the glyph reference for Dyalog differences and Arrays for the array model.

Numbers

Bare numbers are approximate. Use ₓ for machine integers and ᵣ for unbounded integers and exact fractions:

1ᵣ÷3ᵣ
1ᵣ3

Complex numbers use j between real and imaginary parts. Functions such as square root extend into the complex domain:

√¯4
0ⱼ2

See Numbers for conversion and mixed arithmetic.

Array literals and broadcasting

Write matrix rows directly in an array literal. Leading-axis agreement lets a vector supply one offset per row:

m←[1 2 3
   4 5 6]
m+10 20
11 12 13
24 25 26

See array notation and broadcasting.

Keys and named axes

Axes can have names, and positions along them can have string keys. Describe the axes once, then select by key or reduce by axis name:

axes←["city":"NY" "LA";"month":"Jan" "Feb" "Mar"]
sales←axes:[10 20 30◇40 50 60]
"LA" "Feb"⌷sales
+/⍠"month" sales
50

["city":2]ρ["NY":60 "LA":150]

Operations such as transpose preserve the names and keys of axes. Arithmetic aligns axes by name and positions by key. See Axis keys.

Function operators

Pass ⍣ a vector of iteration counts to get the history of states, with one state for each count and count 0 as the initial value. Here, double up to four times:

2×⍣(ι5) 1
1 2 4 8 16

@ transforms the argument, applies a function, then reverses the transformation. Scale by ten, floor, and scale back to round down to tenths:

⌊@(10×)1.25 2.78
1.2 2.7

Explore iteration and inverses, Under, windows and function selection.

Mathematical tools

Primes and factorisation are built in:

⨸360ₓ
[2 2 2 3 3 5]ₓ

Polynomials support coefficients, roots and evaluation. Polynomial functions can be differentiated: for f(x) = 1 + 2x + 3x², f′(2) = 14.

f←[1 2 3]ₓ⌻ ◇ f∂2ₓ
14

Probability distributions provide sampling, density, CDF and quantiles. Two fair coin tosses give these probabilities for 0, 1 and 2 heads:

coin←2 0.5 •distribution "binomial"
coin.density 0 1 2
0.25 0.5 0.25

Matrix division handles linear systems and least squares.

Data and text

JSON objects become keyed arrays, with dot access to their fields:

order←•json "{""price"":10.5,""qty"":2}"
order.price×order.qty
21

CSV headers likewise name column vectors. Files, CSV and JSON covers reading, transforming and writing data. Regex supplies matching, captures and replacement through Rust’s regex engine.

Drawing

•plot draws charts from arrays. Keys label the axes and name the lines. See Plots.

["legend":"end"]•plot sales

Build SVG from element functions and keyed attributes. Notebooks display the picture directly. The same element trees can be serialized to XML. See XML and SVG.

[circle text]←•element "circle" "text"
c←circle ["cx":50 "cy":40 "r":25 "fill":"orange"]
t←["x":50 "y":85 "text-anchor":"middle"]text "Hello, SVG"
["width":240 "height":240]•svg c t

Python

BPL functions are Python callables:

from basedpl import fn

mean = fn('+/÷≢')
mean([1, 2, 3])

Arrays have .py, .np and .df conversions for Python values, NumPy and pandas. Functions also have Python names and composition operators. See the Python tutorial.

For other frontends, the process interfaces provide JSON messages and interruptible workers. The BPL library contains more algorithms, codecs, interpreters and puzzles.

Metadata

Release files for basedpl 0.1.92

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

Source distribution (sdist)

Source distribution for basedpl 0.1.92
File Size Uploaded Provenance Actions
basedpl-0.1.92.tar.gz 3.4 MB With provenance Details for basedpl-0.1.92.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for basedpl 0.1.92
File Actions
basedpl-0.1.92-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64 Details for basedpl-0.1.92-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.92-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ ARM64 Details for basedpl-0.1.92-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.92-cp313-cp313-macosx_15_0_arm64.whl CPython 3.13 CPython 3.13 macOS 15.0+ ARM64 Details for basedpl-0.1.92-cp313-cp313-macosx_15_0_arm64.whl
basedpl-0.1.92-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64 Details for basedpl-0.1.92-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.92-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ ARM64 Details for basedpl-0.1.92-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.92-cp312-cp312-macosx_15_0_arm64.whl CPython 3.12 CPython 3.12 macOS 15.0+ ARM64 Details for basedpl-0.1.92-cp312-cp312-macosx_15_0_arm64.whl
basedpl-0.1.92-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details for basedpl-0.1.92-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.92-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ ARM64 Details for basedpl-0.1.92-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.92-cp311-cp311-macosx_15_0_arm64.whl CPython 3.11 CPython 3.11 macOS 15.0+ ARM64 Details for basedpl-0.1.92-cp311-cp311-macosx_15_0_arm64.whl

Total release size: 242.8 MB

Release files / basedpl-0.1.92.tar.gz

Download URL basedpl-0.1.92.tar.gz
Size 3.4 MB
Tags Source
SHA-256 checksum
How to use checksums
84a5690c58cbce58f67044d5ab8cd84e9ed57bf2c785de5afc2313a3fd100349
BLAKE2b-256 checksum
How to use checksums
5796a99dca8f7251bc8dcb2c2d1460fd131e420e5fd4c5284cebe406886a6802
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL basedpl-0.1.92-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 31.0 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
8dcfc38a95c0601d3f6a6dceae2f6016b11192aa318ab6932c4e20c891cd698d
BLAKE2b-256 checksum
How to use checksums
83425c43063110c455aa7c5ea7d4ca34ae235c22fe12f26a3ad8ba298d59a750
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL basedpl-0.1.92-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 24.7 MB
Tags CPython 3.13 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
f2a18a392825643627aad71f1e698d3111045766e807de46d71b5aab60b11631
BLAKE2b-256 checksum
How to use checksums
94c30eb052f5c8834c7f7a0978e8e0bcd9e0b7457a59c91f81fa5309c1e2bbd5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp313-cp313-macosx_15_0_arm64.whl

Download URL basedpl-0.1.92-cp313-cp313-macosx_15_0_arm64.whl
Size 24.0 MB
Tags CPython 3.13 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
d25ac96a525ae9a0a98ccdcbaba383e38226ddbfd1a45be7cd8570fcf2a452cf
BLAKE2b-256 checksum
How to use checksums
0d1a7271c75742467a4aeffa11f28b14f0f212fefbdc4eda0c1ddd4b202fca2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL basedpl-0.1.92-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 31.0 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
e16b5d1906db92e67c6e3ec1cdbbe33be0bcbb8d68c5483d10249a2cde502ca7
BLAKE2b-256 checksum
How to use checksums
79c4dcf7f1c6586648bea89503e8b6d727e6f595eb0a40108b686958121c9a5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL basedpl-0.1.92-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 24.7 MB
Tags CPython 3.12 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
708a4f1e3d5969cd9d0d3ba801238d58adde39d9a465a56576b1b6b0d098f54f
BLAKE2b-256 checksum
How to use checksums
05a347d0617769985d76f060284560b9aeaf23ad582b018b916d97575d226290
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp312-cp312-macosx_15_0_arm64.whl

Download URL basedpl-0.1.92-cp312-cp312-macosx_15_0_arm64.whl
Size 24.0 MB
Tags CPython 3.12 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
565bd7b7e97cc41d151f960b62e6a918299e1aba446415ac2bb203e12e43b09f
BLAKE2b-256 checksum
How to use checksums
8572c566ca9f776f88063ba89620e7504662abcdace73a44318db2f00a08cc92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL basedpl-0.1.92-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 31.0 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
54ae0e1172e887cc6f2daea8ce2b8dc10f8613a4131bc8bbab85e075e42b6ed5
BLAKE2b-256 checksum
How to use checksums
a1f1f1521f7911c070b3adc2309d204e8142025dd62fed02d43fa0174a12e670
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL basedpl-0.1.92-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 24.7 MB
Tags CPython 3.11 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
d2dbc2cfe7ae186276534324eb7bdde878e8ae87b492869b0151df525c15264f
BLAKE2b-256 checksum
How to use checksums
033ae0ec6a80eac4c63a1cbd0fe17ce12667a91898302b67efb21272bde25a51
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / basedpl-0.1.92-cp311-cp311-macosx_15_0_arm64.whl

Download URL basedpl-0.1.92-cp311-cp311-macosx_15_0_arm64.whl
Size 24.0 MB
Tags CPython 3.11 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
84bb33f32344ea74620778daa18153c7cf17e61364a665efb6af72f3d1700ced
BLAKE2b-256 checksum
How to use checksums
92375241a10f7b2883465c55b52b682cc191c6a9910af1d6258536e6eea3289c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for basedpl 0.1.92

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.

Full provenance

All 10 files in this release have been uploaded with provenance metadata.

Select from 10 files

Attestation for basedpl-0.1.92.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

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.

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