Skip to content
quqiufengPublic

About

a python subset for ai agents native and no pip

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

StaticPy

一个小 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}

三条"补齐运行时"的路径

  1. 有现成 C 库 → 运行时挂 .so(libgif/libwebp/libtiff/libfreetype)
  2. 没有 → 自写 C++ helper(libimgproc.so)
  3. 语法不够兼容 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 构建用户程序

LuaJIT 集成(编译时编入)

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 即可(仅用于"测量"对照,不进产物)

About

a python subset for ai agents native and no pip

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages