jmax 0.1.0

Math-native programming language replacing MATLAB / Julia / R / Mathematica. Stub installer; `cargo binstall jmax` fetches the real binary.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

# JMax

**A math-native programming language for science, data, and visualization.**

JMax is what you'd build if you started from "I want MATLAB / Julia / R / Mathematica, but as a single self-contained tool with no install dance and 2,500 functions built in." It's a complete data-science surface — linear algebra, signal processing, plotting, statistics, ML primitives — projected onto [flowG](https://github.com/openIE-dev/flow-g) so the same code runs on CPU, Apple-silicon Metal, or WebGPU.

This is the **public release surface**. Source is private at [`openIE-dev/jmax-core`](https://github.com/openIE-dev/jmax-core).

## Status

> Release binaries + examples + documentation. JMax is **free to use software**, not an open-source project. See [LICENSE](./LICENSE) for Business Source License 1.1 terms — converts to Apache-2.0 four years after each binary's release date.

## What you get

| Binary | Purpose |
|---|---|
| `jmax` | The JMax CLI: REPL, file runner, formatter, MCP server |

Plus a Rust library, [`jmax`](https://crates.io/crates/jmax), for embedding.

## Install

```bash
# via cargo
cargo install jmax

# via cargo-binstall (prebuilt binary)
cargo binstall jmax

# direct download
curl -fsSL https://github.com/openIE-dev/jmax/releases/latest/download/jmax-$(uname -s)-$(uname -m).tar.gz | tar xz
```

Platform support:

| Platform | Status |
|---|---|
| macOS arm64 (Apple Silicon) | shipping |
| macOS x86_64 | shipping |
| Linux x86_64 (musl) | shipping |
| Linux aarch64 (musl) | shipping |
| Windows x86_64 | shipping |
| WASM (browser) | shipping |

## Hello, JMax

```jmax
# JMax script: solve a linear system, plot, and energy-receipt the work
A = randn(1000, 1000)
b = randn(1000)
x = A \ b
norm(A * x - b)
```

```bash
jmax run examples/linear-algebra/solve.jm
```

REPL:

```bash
jmax repl
```

See [`examples/`](./examples/) for linear algebra, signal processing, plotting, science notebooks, and the JMax → flowG projection.

## What makes JMax different

- **2,502 scientific computing functions** — across 82 modules — that you can `import` without installing anything else. Linear algebra, FFT, optimization, statistics, ML primitives, file IO, plotting, all in the same binary.
- **`.jm` files run anywhere** — same code on CPU, GPU, WGPU via flowG dispatch.
- **Energy receipts** — every workload optionally records picojoule-per-operation via the substrate-energy layer.
- **MCP server built in** — JMax exposes its computation surface as an MCP server (`jmax mcp`) so any LLM agent can route math through it.
- **Pure Rust** — no Python, no C++ shared libraries, no LAPACK or BLAS to install. JMax compiles to a single binary.

## How it fits

JMax is the **scientific-computing surface** in the openIE-dev family:

- [flowG](https://github.com/openIE-dev/flow-g) — the substrate JMax compiles to
- [Lux](https://github.com/openIE-dev/lux-lang) — general-purpose sibling
- [Joule](https://github.com/openIE-dev/joule-lang) — energy-budgeted compiled sibling
- [JouleDB](https://github.com/openIE-dev/jouledb) — the metered database for persistence

## Documentation

- Getting started → <https://openie-dev.github.io/jmax>
- Examples → [`examples/`](./examples/)
- Function reference → <https://openie-dev.github.io/jmax/reference>
- Source mirror → [`openIE-dev/jmax-core`](https://github.com/openIE-dev/jmax-core)

## Releases

[GitHub Releases](https://github.com/openIE-dev/jmax/releases) — tagged versions with prebuilt binaries for every supported platform, plus SHA-256 checksums.

## Community

- [Discussions](https://github.com/openIE-dev/jmax/discussions) — Q&A, function requests
- [Issues](https://github.com/openIE-dev/jmax/issues) — bug reports
- Security: see [SECURITY.md](./SECURITY.md)

## License

- **Binaries** — Business Source License 1.1; see [LICENSE](./LICENSE). Free for non-commercial use, internal use by orgs under $1M revenue, security/academic research. Converts to Apache-2.0 four years after each release.
- **Documentation** — CC-BY-4.0
- **Examples** — Apache-2.0