Skip to main content

just-makeit

CI Docs codecov PyPI Python C99 C++11 MSVC ABI jbx

Getting an algorithm right is paramount. Yet it's rarely the bottleneck. Turning it into shippable code — a tested C library, a Python binding, a build system, packaging, and a public C API that Rust or C++ can also link — is the tedious, exacting work that repeats on every project.

just-makeit new scaffolds the whole thing in one command: core C library, thin Python binding, CMake build system, and full test coverage — all passing before you write a single line of your algorithm.


Quickstart

Recommended: jbx, the same line on every platform. Without jbx yet, getting jbx is one line first.

jbx just-makeit:install

Run in a project's root, it installs into that project's .venv; anywhere else, if jm is not found in a new shell, run jbx update-path once.

A project's root is a directory holding pyproject.toml or just-makeit.toml; there jm lives in the project's own venv, on your PATH whenever that venv is, and jbx puts it on this shell's PATH at once. Anywhere else jm goes into a per-user venv that survives a reboot, and on Linux and macOS install.sh (below) links jm and jm's other commands into ~/.local/bin, beside jbx, saying so if that directory is not on your PATH. From Windows PowerShell, jbx just-makeit:install runs install.ps1 (below) in the window itself, so jm is on its PATH at once.

Other ways. install-deps installs cmake, a C compiler, pkg-config and, on Linux, patchelf through your system package manager (only when one of them is missing), then numpy and just-makeit into a Python venv, chosen by the same rule (or pass your own path). Run just-makeit install-deps --help for the full reference.

curl (auto-installs dependencies, creates and activates venv):

. <(curl -fsSL https://just-buildit.github.io/just-makeit/install.sh) [-- path]

Append --check to report what would change without installing anything, or --force to reinstall just-makeit even when it is current.

pip:

pip install just-makeit && just-makeit install-deps [path]

uv:

uv tool install just-makeit && just-makeit install-deps [path]

Windows PowerShell, without jbx:

irm https://just-buildit.github.io/just-makeit/install.ps1 | iex

It installs jm into its own venv and puts it on this window's PATH; the compiler is Visual Studio's clang-cl. See Building on Windows.

Docker (no install needed):

docker run --rm -it ghcr.io/just-buildit/jm-examples-linux:latest

Quick examples

Simple standalone extension:

just-makeit new my_project --object engine --state gain:double:1.0
cd my_project && make && make test

Module subpackage — multiple types in one .so:

just-makeit new my_filters --module filter
cd my_filters
just-makeit object fir    --module filter \
    --state "coeffs:float[16]" --state "delay:float _Complex[16]" --state "gain:float:1.0"
just-makeit object biquad --module filter \
    --arg-type float --return-type float \
    --state "b0:double:1.0" --state "b1:double:0.0" --state "a1:double:0.0"
make && make test
from my_filters.filter import Fir, Biquad   # one .so, one import

What you get

my_project/
├── native/
│   ├── inc/my_project/engine/engine_core.h   # public C API + inline step()
│   ├── src/engine/
│   │   ├── engine_core.c          # block processor + lifecycle
│   │   └── engine_ext.c           # thin Python binding
│   └── tests/test_engine_core.c   # CTest
├── src/my_project/
│   ├── engine.pyi                 # type stub
│   └── tests/test_engine.py       # pytest / unittest
├── cmake/my_project.pc.in         # pkg-config template
├── CMakeLists.txt
├── Makefile
├── just-makeit.toml
├── objects/engine.toml            # engine's manifest fragment
└── bootstrap.toml            # tool + system-dep manifest (jbx install-deps)

bootstrap.toml lists the system packages a build needs, per package manager. jbx installs them: jbx install-deps -g dev picks your OS's package manager.


C API

my_project_engine_state_t *my_project_engine_create(double gain);
void my_project_engine_destroy(my_project_engine_state_t *state);
void my_project_engine_reset(my_project_engine_state_t *state);

static inline float _Complex
my_project_engine_step(const my_project_engine_state_t *state,
                       float _Complex x);

void my_project_engine_steps(my_project_engine_state_t *state,
                             const float _Complex *input,
                             float _Complex *output, size_t n);

double my_project_engine_get_gain(const my_project_engine_state_t *state);
void my_project_engine_set_gain(my_project_engine_state_t *state, double val);

Every C symbol jm derives carries [project] c_prefix, which jm new sets to the project name; jm new --no-c-prefix gives bare engine_create.

Python API

from my_project import Engine
import numpy as np

obj = Engine(gain=2.0)

y = obj.step(1.0 + 0.5j)

x = np.ones(1024, dtype=np.complex64)
y = obj.steps(x)          # allocates output ndarray
obj.steps(x, out=y)       # zero-copy

obj.set_gain(0.5)
obj.reset()

with Engine() as e:
    y = e.steps(x)

Requirements

  • Python 3.9+
  • CMake ≥ 3.16
  • A C99 compiler (GCC or Clang; on Windows, clang-cl — not MSVC's cl.exe)
  • NumPy (runtime, for generated projects)

Full documentation →

Authors

Matthew T. Hunter, Ph.D. and Claude Code

Metadata

Release files for just-makeit 0.130.1

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

Built distribution (wheel)

Table of built distributions (wheels) for just-makeit 0.130.1
File Interpreter ABI Platform Actions
just_makeit-0.130.1-py3-none-any.whl Python 3 none any Details for just_makeit-0.130.1-py3-none-any.whl

Release files / just_makeit-0.130.1-py3-none-any.whl

Download URL just_makeit-0.130.1-py3-none-any.whl
Size 2.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6f57e565d3061815657cee8c820efb5bd93b87e7962591b8f72832963ec2d38f
BLAKE2b-256 checksum
How to use checksums
3bf2f5900883a42a08a2223501e722025f1da8ed2c7d3cba412350685f24225f
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 17, 2026.

Transparency log

Security for just-makeit 0.130.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.

Full provenance

1 file in this release has been uploaded with provenance metadata.

Attestation for just_makeit-0.130.1-py3-none-any.whl

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 17, 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.

Release history Release notifications | RSS feed

This release

0.130.1 This release

1 release file Full provenance

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