Build a custom machine

Quickstart

Python SDK version 1

Nothing needs to be on your computer first, and nothing here needs an Ownbox until step 5.

$ curl -fsSL https://www.ownbox.io/install.sh | sh

Paste it into Terminal. It installs the ownbox command, writes a starter machine and opens it in your browser. No sudo, no account.

Write a starter. It makes a folder named for the machine, holding machine.yaml and __init__.py:
Terminal
```
ownbox new quote-follow-up
```
Run it on your computer. It runs once against a local Ownbox with sample data and shows what it would have done. Nothing leaves your computer:
Terminal
```
ownbox run quote-follow-up
```
To see its pages, open them in your browser, drawn as the Ownbox draws them, on the same sample data:
Terminal
```
ownbox preview quote-follow-up
```
Make it yours. Ask for what it touches under permissions:, then add its jobs and its pages. Run it again after each change, or reload the preview. ownbox example lists whole machines to start from instead.
Send it to the Ownbox. Connect your AI to the owner's Ownbox (the owner's Developers page shows the one line that does it, Routes and tools) and ask it to build a custom machine from my files. It reads this guide from the Ownbox (core.dev_reference), then asks the owner to let it build (core.propose_dev_build). Once the owner says yes on Approvals, the Ownbox checks the files and runs them dry. Your AI follows the build with core.dev_build.
The owner approves it. The review card shows each permission in plain words, and how the dry runs went. The owner's Approve installs it. On a partner's Ownbox, Approve sends it to Ownbox, and it installs on Ownbox's yes.

It worked when the machine's page opens at https://<the Ownbox>/my/quote-follow-up, and its first job has run.