TL;DR

The Scrollcase mental model is simple:

write a scroll
↓
define and lock dependencies
↓
build the box

flowchart TB
    subgraph Dev ["1. Developer Workspace"]
        direction TB
        A["Scroll & Code"]
        B["Dependencies"]
        C["Scrollcase CLI"]
    end

    subgraph CLI ["2. Scrollcase Engine"]
        direction TB
        D["scrollcase lock"] --> E["scrollcase build"]
    end

    subgraph Package ["3. Build Result"]
        direction TB
        F["Box (.zip)"]
        G["Signed Manifest"]
    end

    subgraph Consumer ["4. Consuming Application"]
        direction TB
        H["Download, Verify & Run"]
    end

    Dev --> CLI
    CLI --> Package
    Package --> I["Distribution"]
    I["Distribution"] --> Consumer
    Consumer --> L["End User"]

Initial setup

1. run npm install -g scrollcase to install the CLI
2. run scrollcase init to create the workspace and runnable native example
3. optionally run scrollcase new scroll for real project metadata
4. review the selected scroll
5. define the dependencies
6. run scrollcase lock <boxId>/<targetId>
7. generate or configure the signing key
8. run scrollcase build <boxId>/<targetId>

Normal update

1. update code, version, weights, or dependencies
2. re-run scrollcase lock <boxId>/<targetId> only when required
3. run scrollcase build <boxId>/<targetId>

Responsibility split

Decides what the box contains, writes the scroll, defines dependencies, runs the commands, publishes releases, and implements integration in the application.

Builds the environment, downloads and verifies assets, prepares the box, runs tests, creates archives, generates manifests, calculates hashes, and signs the release.

Selects and downloads the box, supplies local inputs to a conforming consumer, and manages updates, activation, rollback, and removal.

Uses the feature exposed by the application; does not interact with Scrollcase directly.

The most demanding parts are usually:

• defining a correct scroll;
• dealing with difficult scientific dependencies;
• integrating distribution and lifecycle policy with the Node or Python consumer.

Conceptually, Scrollcase is therefore fairly linear: the developer declares the desired environment, and the tool turns that declaration into a distributable and verifiable release.

What Scrollcase simplifies

Scrollcase removes much of the repetitive work required to turn a Python environment into a distributable product.

Without a tool like this, the developer would have to manage:

• environment creation;
• exact dependency versions;
• relocatability;
• native dependencies;
• verified downloads;
• manifests;
• signatures;
• hashes;
• release structure;
• tests;
• distribution conventions.

With Scrollcase, these concerns are collected into a scroll and a small number of commands.