ownbox
The developer kit for Ownbox: write a custom machine for an Ownbox, and run it on your own computer against a local Ownbox.
pip install ownbox
ownbox new visit-reminder # a starter machine, in ./visit-reminder
ownbox run visit-reminder # run it once, and read what it would have done
ownbox preview visit-reminder # open its page in your browser, drawn as your Ownbox draws it
ownbox example # two whole machines to start from: a med spa's report, a gym's check-ins
Nothing to sign up for and nothing to buy to start: all of it runs on your own computer.
A custom machine is a folder: machine.yaml says what it may touch, and __init__.py is its code, written against
from core import sdk. A new one opens as a page, a dashboard named for it with what it does, its own latest data and
Run now, and ownbox run draws that page as your Ownbox will. ownbox run starts it the way an Ownbox does, with the standard library and the SDK only, and
answers every call from a local Ownbox:
- reads of people, conversations and drafts come from invented sample data, or from your machine's own
fixtures/box.json; - sends, spends and proposals are not made, and you read what they would have been, and what each approval would carry out once its owner says yes;
- the AI answers one fixed sentence;
- the internet is not reached. On an Ownbox, its owner allows a host before a test reaches it.
ownbox preview opens its pages in your own browser, drawn by your Ownbox's own renderer in its own look, on the same
sample data: its figures and lists, its settings form (what you save, it reads), and Run now. Change its code and reload
the page: the preview starts it again with the new code, its settings kept. It listens on 127.0.0.1 only and reaches
nothing outside your computer.
Its code lives with you: in that folder on your own computer, and if you like, your own GitHub (or any git) repository. Your Ownbox needs neither. When it does what you meant, connect your Claude to your Ownbox (its Developers page has the one line) and ask it to send the machine there: your Claude sends the files, your Ownbox checks and dry-runs that exact build, and its owner says yes on Approvals before anything runs. Your Ownbox keeps the installed copy and its versions, and never pulls code from GitHub.
On a partner's Ownbox, one more yes: when the build is ready, Approve on its card sends it to Ownbox, and Ownbox reads the code and approves it before it installs there. The card says when it is waiting for Ownbox.
Metadata
Release files for Ownbox 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ownbox-0.1.6.tar.gz | 95.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ownbox-0.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 202.1 kB
Release files / ownbox-0.1.6.tar.gz
| Download URL | ownbox-0.1.6.tar.gz |
|---|---|
| Size | 95.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38722047b79880bfa5c70a055c4037d13bb17b7cd93f10c49413026124873122
|
|
BLAKE2b-256 checksum How to use checksums |
b092580e999db1edb5590a5c9b6393c830d42762bd4d44e28201fff4b214b5b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / ownbox-0.1.6-py3-none-any.whl
| Download URL | ownbox-0.1.6-py3-none-any.whl |
|---|---|
| Size | 106.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a9c440f69435c108be2ba87472a0766f47b7ffd5f6c4f16d879a029e0aee5560
|
|
BLAKE2b-256 checksum How to use checksums |
21ec74c2164bfd01f4de71fe13651d40e91e8ebfa82a2e9708cb4a9eb2a57de9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log