一个小 Python 子集 + 一个用 C ABI 拼起来的生态;可自举、可审计,因而可信任。 A small Python subset with an ecosystem assembled over a plain C ABI — self-hosting and auditable, hence trustworthy.
Python 语法 → Scheme(Chez) IR → AOT 机器码,产物是独立 ELF/.so;
需要什么能力就运行时挂 C 库(FFI),不依赖 Python 解释器 / pip / venv。
定位:把 Python 的表达力接到原生后端上——不是重造语言,而是把成熟的 前端(Python 语法)、后端(Chez Scheme)、原生能力(C 库)对齐成一套给 AI agent 用的约定。
见 CAPABILITIES.md:已集成库/工具、可做工具(模型已就位)、游戏相关能力、边界。
一门 AI 设计、AI 使用、人类监督的语言——语法可被智能体演化,约定(契约+参照+证据+溯源)钉死。 人类给"要什么、算不算数",AI 定"怎么写、怎么验、怎么交"。详见 VISION.md。
staticpy/ # 语言工具链
├── static_translate.py # Python → Scheme 翻译器(含本地补丁:is None / break-continue /
│ # 模块级变量 / 顶层语句 / float ABI / lambda+一等函数)
├── static_prelude.scm # 运行时值类型
├── static_stdlib.scm # 标准库
├── static_build.sh # 上游构建脚本
└── static_build_comfycli.sh # 本项目构建脚本(translate + Chez AOT + 独立 ELF)
imgproc/ # 「StaticPy 版 Pillow」——图像处理库(本轮迁移样板)
├── pil_lib.static.py # 库(纯函数,可被集成;lambda/一等函数)
├── pil_cli.static.py # pil CLI 分发
├── pilcli.static.py # 早期 CLI
├── mirror_gif.static.py # 示例算子
├── concat.static.py # 构建工具(自举:用 StaticPy 写)
├── build.sh / build_app.sh
├── pyimgproc.py # libimgproc.so 的 ctypes 绑定(差分测试用)
├── pil_surface.py # 自省 Pillow API → 清单
├── frontend_coverage.py # 自省清单核对覆盖面
├── difftest.py # 自动化差分测试:PIL vs 我们,逐像素
├── README.md / MIGRATION.md / pil_api.md
└── examples/
cpp/imgproc/ # C++ 底层库 libimgproc.so(对标 Pillow libImaging)
├── core.cpp geom.cpp color.cpp ops.cpp filters.cpp draw.cpp
├── effects.cpp quant.cpp lut.cpp
├── imgproc.h imgproc_internal.h
├── build_cpp.sh
└── thirdparty/{giflib,stb}
- 有现成 C 库 → 运行时挂
.so(libgif/libwebp/libtiff/libfreetype) - 没有 → 自写 C++ helper(
libimgproc.so) - 语法不够兼容 Python → 改编译器(对齐 Scheme IR)—— 已加 lambda/一等函数
bash imgproc/build.sh # C++ 库 + StaticPy ELF(pil/mirror_gif 等)
LD_LIBRARY_PATH=$PWD/cpp/imgproc/build ./imgproc/pil convert IN.png OUT.png L
bash imgproc/build_app.sh my_app.static.py my_app # 用 pil_lib 构建用户程序C ABI 是共享的运行时表面:同一份 libimgproc.so 被 StaticPy(FFI)、Python(ctypes)、LuaJIT(ffi.C) 共用。
更进一步,可把 LuaJIT + 运行时静态编进一个单文件 ELF(无动态 luajit 依赖):
bash luajit/embed-build.sh # → ./lua_app(内嵌 LuaJIT + 图像运行时)
./lua_app IN.png OUT.png # 内嵌 Lua 脚本,ffi.C 直接调运行时函数
./lua_app my_script.lua # 或跑指定 Lua 脚本工具链可自举:上游 ReScheme 记录了三环自举(ReSchme/StaticPy/.sp)与信任链,
最终收敛到一段 ~1100 行的 .sp 编译器作为信任根(几天可完整审计)。
即"编译器/解释器只是约定的实现"——可替换、可自持、可审计。
产物可打成自包含目录:把 ELF + 它用到的**全部 .so(含传递依赖)**一起放进包里,
配一个设 LD_LIBRARY_PATH=$DIR/lib 的启动器。目标服务器零要求——不需要 Python、
不需要 pip、不需要任何预装库;scp 过去 ./run 即可。
mypkg/
├── <name> # 启动器(设 LD_LIBRARY_PATH 后 exec app)
├── app # StaticPy ELF(Chez 运行时已静态嵌入)
└── lib/ # libimgproc.so + libgif/libwebp/libtiff/libfreetype + 传递依赖
bash imgproc/package.sh imgproc/pil pil # -> dist/pil/ 与 dist/pil.tar.gz唯一不可再拆的两样(且都可控):① Linux 内核 + x86-64 架构;② glibc 版本下限
(用老 glibc 的 GLIBC_SYSROOT 构建即可覆盖新老发行版)。其余全在包里。
对比 Go:产物同样是静态单文件;这里是「Python 语法 + 运行时 FFI 任意 C 库」, 交付模型(compile once → copy → run)等价,且宿主不需要任何前置条件。
python3 imgproc/pil_surface.py > imgproc/pil_api.md # 自省清单
python3 imgproc/frontend_coverage.py # 覆盖面
python3 imgproc/difftest.py -v # 差分测试(逐像素)当前:PIL 覆盖面 100/100;差分测试 100/100(多数逐像素 max=0)。
方法与经验见 imgproc/MIGRATION.md。
- 构建:
g++、Chez Scheme(/opt/ChezScheme/ta6le)、pkg-config freetype2 - 运行时:
libgif.so.7、libwebp.so.7、libtiff.so.6、libfreetype.so.6 - 验证脚本:任一装了 Pillow/numpy 的 Python 即可(仅用于"测量"对照,不进产物)