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

The setup command 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

Use bpl -e 'avg←+/÷≢ ◇ avg 2 4 9' for a shell command. 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 shows. 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. Reduce (/) turns addition into summation. ι10 generates 0…9:

+/ι10
45

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

avg 1 2 3 4
2.5

To see how these ideas express an algorithm, start from “a prime has exactly two positive divisors”. Form all remainders of 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]

Keys and names travel with axes through operations such as transpose. Arithmetic aligns matching names and keys. See Axis keys.

Function operators

A vector of counts keeps the history: one state for each count, where count 0 is the initial value. Here, double up to four times:

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

Under (@) 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 serialize to XML. See XML and SVG.

[circle text]←•element "circle" "text"
c←["cx":50 "cy":40 "r":25 "fill":"orange"]circle ""
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.91

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.91
File Size Uploaded Provenance Actions
basedpl-0.1.91.tar.gz 3.4 MB With provenance Details for basedpl-0.1.91.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for basedpl 0.1.91
File Actions
basedpl-0.1.91-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.91-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.91-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.91-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.91-cp313-cp313-macosx_15_0_arm64.whl CPython 3.13 CPython 3.13 macOS 15.0+ ARM64 Details for basedpl-0.1.91-cp313-cp313-macosx_15_0_arm64.whl
basedpl-0.1.91-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.91-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.91-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.91-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.91-cp312-cp312-macosx_15_0_arm64.whl CPython 3.12 CPython 3.12 macOS 15.0+ ARM64 Details for basedpl-0.1.91-cp312-cp312-macosx_15_0_arm64.whl
basedpl-0.1.91-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.91-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
basedpl-0.1.91-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.91-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
basedpl-0.1.91-cp311-cp311-macosx_15_0_arm64.whl CPython 3.11 CPython 3.11 macOS 15.0+ ARM64 Details for basedpl-0.1.91-cp311-cp311-macosx_15_0_arm64.whl

Total release size: 241.6 MB

Release files / basedpl-0.1.91.tar.gz

Download URL basedpl-0.1.91.tar.gz
Size 3.4 MB
Tags Source
SHA-256 checksum
How to use checksums
de4e108fa824ea61076f7b914700a76bc825903176646d39aeba2d444bd94564
BLAKE2b-256 checksum
How to use checksums
9d4c5faf152e000db5e91564258d98403ae15b1ef80dd8e930de377d3fe956da
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 30.9 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
9ada16ec2bfe1fadf849c790fa978c86dd41884a15509e8c7ebb69c40deac786
BLAKE2b-256 checksum
How to use checksums
e1e3eb135552e3bbb0bc7ed1232e9b60955168b9f01cc8c8e2f62e06ca28ec2d
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-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
d8f38d3c52d05c09d1a4cd248e64e37baaa952f1b9d399fe1e40b7063f85539a
BLAKE2b-256 checksum
How to use checksums
87c1507c6d6244716cc1bfba274c9bfec56e7ed2a6addbdd95621912635f18de
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp313-cp313-macosx_15_0_arm64.whl
Size 23.8 MB
Tags CPython 3.13 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
6c3c9bba9558c7bf82454a5b76dfc1b876f99a2f1308d08495d2c39a7d64e800
BLAKE2b-256 checksum
How to use checksums
d5541ee5db60ca204610cb12b307e73af1b1f52ec2d74387ad0f3c8171836348
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 30.9 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
ebdb075633ffb5345ef8e49dd7d0e764629c613f52494a906108772aa58f9dce
BLAKE2b-256 checksum
How to use checksums
f81a6c527a1d14cd6fcf3801e128e5c04e1d5518be123a6eda36059258a3b141
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-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
f7b3695ff7095266d4d684b9753dbc8de6239a38732bd80eafa6642065bfd601
BLAKE2b-256 checksum
How to use checksums
d103f27e7b8d2179100b549e9ac3e9132a3661af68b89377a0fc02d2d0c5c597
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp312-cp312-macosx_15_0_arm64.whl
Size 23.8 MB
Tags CPython 3.12 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
fcf9c9d90e291ad4c9ce69ce365182458da41ac859d5025732b791641459d9a4
BLAKE2b-256 checksum
How to use checksums
e3b34984dc19af0481c31f146ed9064f42b083ca1c7f8f1db0623fd5a70eb2a5
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 30.9 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
d5552eab7dcc4f27d1f93c414f6b6b5b2943951771fda45d8f8c13ffce3d265d
BLAKE2b-256 checksum
How to use checksums
78e89e05f33e6873f5806953a0a76298eb78cc646fc474fbfa3fd6a39a1891a0
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-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
b8cd2aaf09d01aa43aef56275524ab0a1f54cf3d3adb2d0dfbb3dbb3556fec57
BLAKE2b-256 checksum
How to use checksums
286232052248a82bf3f315b17ce3d928051be46021dace147fdc93887bf699b9
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 12, 2026.

Transparency log

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

Download URL basedpl-0.1.91-cp311-cp311-macosx_15_0_arm64.whl
Size 23.9 MB
Tags CPython 3.11 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
cd6549f7078f010c885b7654bd10c329928911cc3876dfa114889f8219da1f0c
BLAKE2b-256 checksum
How to use checksums
a801ea2f93e0a992cf22422c5a5c282fdd6e3f4dc1bee9a924c04a6c1e24a2df
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 12, 2026.

Transparency log

Security for basedpl 0.1.91

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.91.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 12, 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