Docs 2.4.4 · 2 min read

Publishing to apsi.dev — libraries, releases and benchmarks

Everything on the website can be added and removed from the command line on any computer, or with the server command when you are on the server itself.

Libraries (every member)

1. On the site: Settings → Developer → New token, permissions publish:new, publish:update (and yank if you want to remove versions later).
2. Once per computer: apsi lib login --token apsi_…
3. In your library folder:

apsi pack                       # checks the sources, builds dist/NAME-VERSION.apsil
apsi publish                    # uploads it (large files go up in resumable 32 MB pieces)
apsi search physics             # find libraries
apsi install geom-tools         # use one: then `use geom_tools`

Removing a version:

apsi yank NAME 1.2.0            # hidden from new installs; projects that use it keep working (undo: --undo)
apsi unpublish NAME 1.2.0       # deleted for good — allowed in the first 72 hours or while nobody downloaded it

Versions can never be replaced: publish 1.2.1 instead. That guarantee is what keeps everyone's builds reproducible.

Apsi releases (administrators)

Who is an administrator is decided only on the server: signing up never makes one, not even the first account. The owner runs node scripts/admin.js user promote NAME (Windows package: admin user promote NAME) on the server. The release permission is offered only to administrators who have turned on two-factor sign-in, and a release token stops working if two-factor sign-in is turned off or the account is demoted. Tokens are stored as hashes, can expire, and can be revoked in Settings → Developer.

Create a token with the release permission, store it with apsi lib login, then:

apsi release upload ApsiSetup-2.4.4-x64.exe apsi-2.4.4-linux.zip apsi-2.4.4-source.zip --version 2.4.4
apsi release upload apsi-1.10.0-linux.zip --version 1.10.0 --date 2026-11-08T09:00:00Z   # an older version
apsi release list               # ids, sizes, downloads
apsi release hide 7             # / unhide 7
apsi release delete 7           # removes the file for good

The platform is recognised from the file name (.exe → Windows, linux/.deb/.sh → Linux, source → source code); pass --platform to override and --title/--notes NOTES.md for the download page. The newest stable version is what /download shows; every version stays on /download/all.

On the server itself the same works without a token:

node scripts/admin.js release add FILE... --version 2.4.4
node scripts/admin.js release list
node scripts/admin.js release delete 7 8 9
node scripts/admin.js release delete-version 1.10.0       # every file of a version

Benchmarks (administrators)

python3 benchmarks/heavy/run.py --publish 2.4.4                       # numbers appear on /benchmarks live
python3 benchmarks/heavy/run.py --apsi-root ../apsi-1.10.0 --only Apsi --label "Apsi 1.10.0" \
        --merge benchmarks/heavy/results.json --publish 1.10.0        # measure an older version
apsi release bench results.json --version 2.4.4                       # publish an existing results file
apsi release bench --delete 1.10.0                                    # remove a version's results

The benchmarks page shows the newest version first and lets visitors pick any other version and compare two versions side by side.

Found a mistake? Report it · Markdown source