Installation

Install

curl -fsSL https://hub.wippy.ai/install.sh | bash

The install script requires a POSIX shell. On Windows, download the runtime from hub.wippy.ai/releases and place wippy.exe on PATH.

Verify

wippy version

Initialize Dependency Metadata

# Create a project directory
mkdir myapp
cd myapp

# Create or update wippy.lock
wippy init

wippy init writes the dependency lock and its source and module directory settings. It does not scaffold application source files or registry entries. Follow Hello World to create a runnable application, then start it with wippy run.

The runtime includes HTTP, SQL, storage, and process-hosting capabilities. Add framework modules from the Hub when the application needs them:

wippy add wippy/test
wippy install

Commands Overview

Command Description
wippy init Create or update wippy.lock
wippy run Start the runtime
wippy test Run the test entrypoint
wippy lint Check code for errors
wippy add Add a dependency
wippy install Install dependencies
wippy update Update dependencies
wippy artifacts Materialize build-time filesystem artifacts
wippy pack Create a snapshot
wippy publish Publish to hub
wippy search Search for modules
wippy readme Fetch a module README from the hub
wippy registry Inspect loaded registry entries
wippy auth Manage authentication
wippy version Print version info

See CLI Reference for full documentation.

Troubleshooting

If the shell cannot find wippy after installation, reopen the shell and verify that the installation directory is on PATH.

Next Steps