# "Installation"

_Path: en/start/installation_

> "Install the Wippy runtime and verify that the command is available."

## Table of Contents

- Installation

## Content

## Install


```bash
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](https://hub.wippy.ai/releases) and place `wippy.exe` on
`PATH`.



## Verify


```bash
wippy version
```



## Initialize Dependency Metadata


```bash


# 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](tutorials/hello-world.md) 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:

```bash
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](guides/cli.md) 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


- [Hello World](../tutorials/hello-world.md) — Create your first application
- [Project Structure](start/structure.md) — Understand the project layout
- [CLI Reference](guides/cli.md) — Review all commands and options



## Navigation

Previous: What Is Wippy? Concepts and Runtime Overview (start/about)
Next: "YAML & Project Structure" (start/structure)