Installation

This page covers installing Wasmind and its dependencies for different use cases.

For Users: Running Wasmind Configurations

If you want to use Wasmind to run AI agent configurations with the CLI:

1. Install Rust

# Install rustup if you haven't already
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Update to latest stable
rustup update stable
rustup default stable

# Add WebAssembly target for building actors
rustup target add wasm32-wasip1

2. Install the Wasmind CLI

cargo install --locked wasmind_cli

Note: The wasmind_cli is just one frontend to the Wasmind library. Other applications may build different interfaces using the core wasmind library.

3. Install Docker

The wasmind_cli uses LiteLLM via Docker to provide unified access to AI models:

  • macOS/Windows: Install Docker Desktop
  • Linux: Install Docker Engine from your package manager

Note: Other frontends/binaries using the Wasmind library may have different LLM integration requirements. This Docker requirement is specific to wasmind_cli.

4. Install cargo-component

cargo install --locked cargo-component

This is required because Wasmind currently builds all actors locally. This requirement may change in future versions.

5. Verify Installation

wasmind_cli --help
docker --version
cargo component --version
rustc --version  # Should be 1.70+
rustup target list | grep wasm32-wasip1  # Should show "wasm32-wasip1 (installed)"

You should see help output and version numbers for all commands.

For Developers: Building Custom Actors

If you want to build custom actors or extend Wasmind:

Note: Follow all the steps in the "For Users" section above first - the installation requirements are the same, including the wasm32-wasip1 target which is required for building WebAssembly actors.

Next Steps

After installation:

  • Users: Continue to the User Guide to run your first configuration
  • Developers: Continue to the Developer Guide to build your first actor