Shimpz
Executable source reference

Build Hello Pulse.

Generate one dependency-free Assistant, validate its complete source contract, then call its only operation on your own machine.

  1. Check Python

    From a checked-out shimpz-sdk repository, confirm the standard interpreter:

    Terminal · Python
    python3 --version
    Python 3.14.x

  2. Create the project

    The scaffolder publishes atomically and refuses to overwrite an existing destination.

    Terminal · Assistant scaffold
    SHIMPZ_LIB=$PWD/rootfs/opt/shimpz-lib python3 rootfs/usr/local/bin/shimpz-assistant new hello-pulse /tmp/hello-pulse

  3. Validate every reference

    Validation reads the manifest, skill, and operation schemas without printing permissions or source values back to the terminal.

    Terminal · Assistant validation
    SHIMPZ_LIB=$PWD/rootfs/opt/shimpz-lib python3 rootfs/usr/local/bin/shimpz-assistant validate /tmp/hello-pulse

  4. Start the development server

    The reference server binds to loopback by default and exposes only health and hello.

    Terminal one · Hello Pulse
    cd /tmp/hello-pulse
    PORT=8080 python3 assistant/main.py

  5. Call the declared operation

    In a second terminal:

    Terminal two · Operation call
    curl -fsS http://127.0.0.1:8080/health
    curl -fsS -H 'content-type: application/json' -d '{"name":"Ada"}' http://127.0.0.1:8080/v1/operations/hello
    Response · JSON json 
    {
  "message": "Hello, Ada!"
}
Result

What you have proved

  • The scaffold is a valid Assistant Spec v1 source tree.
  • The process has no dependency, credential, Service permission, Assistant permission, or egress.
  • Unknown fields, unknown operations, oversized bodies, and malformed JSON fail closed.
  • The declared routine remains disabled because no local server silently schedules it.

Read the complete Hello Pulse source.