Skip to content

plans: release Eggsearch Python on PyPI with prebuilt ARM/SBC wheels - #10

Merged
dbowm91 merged 15 commits into
mainfrom
plan/python-pypi-prebuilt-arm-release-20261028
Oct 28, 2026
Merged

dbowm91 merged 15 commits into
mainfrom
plan/python-pypi-prebuilt-arm-release-20261028

Conversation

@dbowm91

@dbowm91 dbowm91 commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

Purpose

Register a release-first PyPI distribution workstream for the existing Eggsearch native Python bindings. The user confirmed the eggsearch project name is available on PyPI and directed us to publish prebuilt architecture-correct wheels promptly, explicitly label SBC support experimental, and perform physical-SBC benchmarking after publication. No resource-constrained SBC should compile a wheel or the Rust package.

Planning-only handoff

New subsystem roadmap: plans/subsystems/python-pypi-distribution-roadmap.md.

  • M001 (ready): CPython 3.11–3.15 qualification, matching PyO3/async/Maturin toolchain, preserved abi3-py311, five existing native platform families × five interpreters, sdist/audits/version metadata.
  • M002 (ready): hosted ARMv7 hard-float manylinux_2_31_armv7l wheel; verify ELF/platform/libc and install under hosted QEMU ARMv7. Optional musllinux/i686 coverage where proven. No device-local builds.
  • M003 (ready for implementation; publication gated): exact-SHA wheel/sdist manifest + integrity, GitHub OIDC Trusted Publisher with environment approval, public PyPI upload and independently verified binary-only consumer installations. Publish before hardware benchmarking.
  • M004 (blocked until M003 publication): real SBC runtime/footprint benchmarking of installed PyPI wheels, with no Cargo/compiler on device. Record native evidence and propose tuning only if measured.

Boundaries

Retains the original closed Python native M001–M008 history. No source-code or workflow edits in this PR, no PyPI publication yet, no changes to Eggpack binary assets. M003's publication has strict ABI/metadata/installed-wheel/security gates; experimental SBC means no physical device benchmark yet, not an untested or mislabeled wheel.

The registry and architecture index are updated with the four implementation handoffs.

Reviewer checklist

Confirm release-first dependency graph, ARMv7 required vs optional musl target policy, prebuilt-only SBC installation instructions (pip --only-binary=:all:), exact-SHA provenance/manual approval, and that postpublication benchmarks are not turned into a release blocker.

This PR contains seven planning/documentation files only.

@dbowm91
dbowm91 merged commit 2ac49f6 into main Oct 28, 2026
87 of 89 checks passed
@dbowm91
dbowm91 deleted the plan/python-pypi-prebuilt-arm-release-20261028 branch November 17, 2026 19:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant