# `Kettlecorn.Install`
[🔗](https://github.com/mjrusso/kettlecorn/blob/v0.1.0/host/lib/kettlecorn/install.ex#L1)

Installs the native runtime for this platform from a GitHub release.

`runtime/1` downloads `kettlecorn-runtime-<version>-<system>.tar.gz` and
verifies its SHA-256 against the package's `priv/checksums.txt`. Configure
`:release_base_url` for a mirror with the same release layout. The archive
includes the launcher; no separate Wasmtime installation is needed.

# `archive_name`

Release archive name for this platform.

# `runtime`

```elixir
@spec runtime(keyword()) :: {:ok, Path.t()} | {:error, String.t()}
```

Downloads the release runtime for this version into `:dir` (default:
`Kettlecorn.Runtime.installed_dir/0`). Reuses a compatible installation
unless `force: true`. Publication atomically replaces a symbolic link;
previous generations remain in `<dir>.versions` for existing readers.
Move an existing ordinary directory aside before replacing it, even with
`force: true`.
Returns `{:ok, dir}` or `{:error, message}`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
