Merge pull request #415 from hyperware-ai/hf/setup-make-it-just-work

setup: make it Just Work

Author: nick1udwig

README.md

@@ -96,3 +96,29 @@ NodeJS (v18 or higher) and NPM are required to build and develop the UI.
 The UI is written in React with Vite as the bundler + reloader.
 
 To use `npm start` instead of `npm run dev`, use `kit dev-ui --release`.
+
+## Appendix: Deps for Debian/Ubuntu
+
+```bash
+apt update
+DEBIAN_FRONTEND=noninteractive apt install -y curl git build-essential pkg-config libssl-dev libclang-dev python3 python3-venv
+
+curl https://sh.rustup.rs -sSf | sh -s -- -y
+. ~/.bashrc
+cargo install --git https://github.com/hyperware-ai/kit --locked
+kit setup -d --non-interactive
+. ~/.bashrc
+```
+
+## Appendix: Deps for macOS
+
+```bash
+xcode-select --install
+brew install pkg-config llvm openssl@3 python@3.12 libusb
+
+curl https://sh.rustup.rs -sSf | sh -s -- -y
+. ~/.bashrc
+cargo install --git https://github.com/hyperware-ai/kit --locked
+kit setup -d --non-interactive
+. ~/.bashrc
+```

src/setup/mod.rs

@@ -20,6 +20,7 @@ const MINIMUM_NPM_MINOR: u32 = 0;
 pub const REQUIRED_PY_MAJOR: u32 = 3;
 pub const MINIMUM_PY_MINOR: u32 = 10;
 pub const REQUIRED_PY_PACKAGE: &str = "componentize-py==0.11.0";
+const WASM_TOOLS_VERSION: &str = "1.225.0";
 
 #[derive(Clone)]
 pub enum Dependency {
@@ -476,7 +477,11 @@ fn install_deps(deps: Vec<Dependency>, verbose: bool, toolchain: &str) -> Result
             Dependency::RustWasm32Wasi => {
                 call_rustup("target add wasm32-wasip1", verbose, toolchain)?
             }
-            Dependency::WasmTools => call_cargo("install wasm-tools", verbose, toolchain)?,
+            Dependency::WasmTools => call_cargo(
+                &format!("install wasm-tools --locked --version {WASM_TOOLS_VERSION}"),
+                verbose,
+                toolchain,
+            )?,
             Dependency::Foundry => install_foundry(verbose)?,
             Dependency::Docker => {}
         }