sharepack

Turn a local Python web app into a single HTML file anyone can open. No server, no tunnel, no deploy, no install on either side.

pip install sharepack
sharepack /path/to/your/project -o demo.html

Works with Django, Flask, and FastAPI. Send demo.html over Slack or email. The recipient double-clicks it. Python boots in their browser via Pyodide (WebAssembly), your app runs against a snapshot of your SQLite data, and every click and form submit is handled entirely inside their tab.

Live demos — each built from a fixture app in sharepack's test suite, running entirely in your browser:

• ▶ Fieldnotes — a Django task ledger
• ▶ Clipnotes — a Flask snippet ledger
• ▶ Pulseboard — a FastAPI status board with a JSON API

Why

The existing ways to show someone your local app all have a catch:

Approach	Catch
ngrok / tunnels	your laptop must stay up; exposes a live server
Railway / Render	repo, config, account; overkill for “look at this”
Screen recording	viewer can’t touch it
“Just clone and run it”	recipient is non-technical

sharepack converts running code into static content. The host (email, Slack, a file share) only ever moves bytes. The recipient executes the app in the same browser sandbox as any website they visit.

• Quickstart
  • Install
  • Bundle your project
  • Preview before you build
  • Complete worked examples
  • What your project needs
• How it works
  • The pipeline
  • What gets scrubbed and skipped
  • The browser runtime
  • Honest caveats
  • Prior art
• CLI reference
  • Arguments
  • Options
  • Exit status
  • Examples
• Python API
  • sharepack
  • sharepack.collect
  • sharepack.build
  • sharepack.adapters
• Limitations & FAQ
  • Architectural — will not work, by design
  • Current gaps — may improve in future releases
  • FAQ
• Changelog
  • [Unreleased]
  • [0.1.0] - 2026-07-24