Skip to content

Instantly share code, notes, and snippets.

View esc's full-sized avatar
:octocat:
Open Source FTW

Emergency Self-Construct esc

:octocat:
Open Source FTW
View GitHub Profile
@esc
esc / _kilo
Created August 24, 2026 14:34
kilo zsh completion
#compdef kilo
# -----------------------------------------------------------------------------
# Native zsh completion for the `kilo` CLI (https://kilo.ai).
#
# Hand-written against the CLI reference at:
# https://kilo.ai/docs/code-with-ai/platforms/cli-reference
# Regenerate/diff against `kilo help --all --format md` when the CLI changes.
#
# Dynamic values (models, agents, session ids) are looked up by running kilo
# and cached under ${XDG_CACHE_HOME:-$HOME/.cache}/kilo-completion. Tune with:
@esc
esc / runner-protocol-icebreaking-numba-pull-requests.md
Last active August 18, 2026 19:54
// RUNNER PROTOCOL: ICEBREAKING NUMBA PULL-REQUESTS

// RUNNER PROTOCOL: ICEBREAKING NUMBA PULL-REQUESTS

Read this before you jack in. The deck doesn't care about your reputation, and neither does the compiler.

  • The Numba syndicate builds and tests on conda. Street-grade pip is cut with garbage — don't shoot it into the mainline. Every patch you crack gets its own sealed construct, no bleed-through. The clean rig is racked at ~/miniconda3; that's your safehouse, that's where the executable sleeps.
@esc
esc / agents.md
Last active August 27, 2026 20:47
Numba instructions for agents

Instructions for agents when asked to review Numba pull-requests.

  • The Numba project uses conda for building and testing, avoid using pip to install packages and create isolated environments for PR reveiw. A base environment that contains the executable should be at ~/miniconda3
  • llvmlite is a subproject of Numba and follows these guidelines too.
  • If you need to install depenedencies for testing and review environments take a look at this makefile for inspiration: https://github.com/esc/numba-dev-files/blob/master/Makefile
  • Don't use the gh tool for interfacing with GitHub, use git to look at files locally and do checkouts and then use curl to access the GitHub web-interface. If a git remote is using the ssh protocol, feel free to reconfigure the (read-only) https protocol instead to fetch pull-requests.
  • Multiple agents may work on this directory, operate in a way that does not interfere with other agents
@esc
esc / gist:f9f1d2ae9bf0cc2cf107477d70b9a9e0
Last active August 7, 2026 12:51
Numba PR 10761 Review by Kimi K3 and esc

Code Review — PR #10761: Fix np.clip writing past the end of a caller-provided out= array

  • Reviewer: Kilo (senior-engineer pass) and Kimi K3
  • Date: 2026-08-05
  • Branch: fix-10682-clip-out-shape @ 162521a9a0, merge base 0d0938a717
  • Local env: macOS arm64, Python 3.14, NumPy 2.3.5, numba 0.68.0dev0+14.g162521a9a0 (in-place build)

Verdict

Approve. This fixes a genuine memory-corruption bug: a too-small out= was written past

numba_cov_active:
NUMBA_JIT_COVERAGE=1 pytest --cov=issue_9859 test_issue_9859.py
numba_cov_disable:
NUMBA_JIT_COVERAGE=0 pytest --cov=issue_9859 test_issue_9859.py
@esc
esc / numba.typed.List-benchmark-001.ipynb
Last active May 24, 2024 09:25
numba.typed.List-benchmark-001.ipynb
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@esc
esc / vision.txt
Created February 22, 2022 17:24
Numba Vision Stuart
What should Numba be?
* Numba, as in the code base, should really be an extensible toolkit for writing compilers, the default user facing front end of which is _an_ implementation of a compiler for Python and (maybe!) NumPy.
* It needs to be sufficiently extensible to cover the spectrum of use cases, including but not limited to:
* Typical users, just wanting to @jit some numerical functions (many many users, the most common use case)
* Those providing libraries for domain specific use (e.g. researchers - TARDIS-SN)
* Those providing libraries for use in scientific computing as part of the numerical python scaffold (e.g. pydata-sparse)
* Those writing more advanced libraries containing their own data types etc (e.g. AwkwardArray)
* Compiler extenders wanting to write and explore new compiler use cases/needing a custom compiler (e.g. Bodo, omnisci-db)
* Hardware vendors wanting to extend Numba support to their custom silicon (e.g. NVIDIA, Intel)
@esc
esc / vision.txt
Created February 8, 2022 17:33
Val's Numba Vision -- Anarcho Utilitarianism
Numba Vision (Anarcho Utilitarianism)
=====================================
* A kick-ass Python compiler. (Money, Fame, ...)
* A tiny Numba core, barebones library, with useful
abstractions/contracts/interfaces (Essentialism)
* A compiler library to build other compilers on top of. (Framework/Structure)
* A platform for compiler profiling and debugging research. (Creativity)
* A platform for exploring novel scientific algorithms. (Innovation)
* An ecosystem of Numba open extensions/add-ons/utilities/libraries for
@esc
esc / pip_install.log
Created April 27, 2021 10:45
pip installation failure
sudo pip install packaging
Traceback (most recent call last):
File "/usr/local/bin/pip", line 7, in <module>
from pip._internal.cli.main import main
File "/usr/local/lib/python3.6/site-packages/pip/_internal/cli/main.py", line 9, in <module>
from pip._internal.cli.autocompletion import autocomplete
File "/usr/local/lib/python3.6/site-packages/pip/_internal/cli/autocompletion.py", line 10, in <module>
from pip._internal.cli.main_parser import create_main_parser
File "/usr/local/lib/python3.6/site-packages/pip/_internal/cli/main_parser.py", line 8, in <module>
from pip._internal.cli import cmdoptions
@esc
esc / links.txt
Last active December 18, 2020 10:34
My Twitter Question about Open Source and Community