Installing WASP

WASP (WebAssembly Agent System Platform) is available on GitHub on GitHub official WASP repo. This guide will walk you through the installation process and get you started with WASP development.

Prerequisites

Before installing WASP, ensure your system meets the following requirements:

1. Rust

   • Latest stable version of Rust

   • Install from https://rustup.rs/

2. Node.js

   • Version 14 or higher

   • Download from https://nodejs.org/

3. WebAssembly Target

   • Required for compiling Rust to WebAssembly

   • Install using rustup:

   rustup target add wasm32-unknown-unknown

Installation Methods

You have two options for installing and setting up WASP:

Option 1: Quick Start with NPX (Recommended)

This is the fastest way to get started with a new WASP project:

# Create a new UOMI agent project
npx wasp create

This command will:

• Create a new project directory

• Set up the required project structure

• Install necessary dependencies

• Configure the development environment

Option 2: Manual Setup

If you prefer more control over the setup process, you can manually clone and configure the project:

1. Clone the repository:

git clone https://github.com/Uomi-network/uomi-chat-agent-template.git

1. Navigate to the agent directory:

cd uomi-chat-agent-template/agent

1. Install dependencies:

npm install

1. Make the build script executable:

chmod +x ./bin/build_and_run_host.sh

1. Start the development environment:

npm start

Verifying Installation

To verify that WASP is installed correctly:

1. Start the development environment:

npm start

1. You should see the UOMI Development Environment interface:

UOMI Development Environment
Type your messages. Use these commands:
/clear - Clear conversation history
/history - Show conversation history
/exit - Exit the program

Available AI Models

Available AI models can be found in the Models page, using different IDs in the call_ai_service call will cause the agent to crash and not work

Next Steps

After installation, you should:

1. Configure your development environment in uomi.config.json

2. Set up your AI model preferences (local node-ai or third-party services)

3. Familiarize yourself with the project structure

4. Try running the example agent

AI Service Configuration

You have two options for AI service integration:

Option 1: Local Node-AI Service (Recommended)

Follow the node-ai repository setup to run the production version locally. With this option, you don't need to specify URL or API keys in your configuration.

Option 2: Third-Party Services

If you prefer using external services like OpenAI (This method does not guarantee determinism as the model result in tests, the model result may be different from the one in production), configure your uomi.config.json:

{
  "models": {
    "1": {
      "name": "gpt-3.5-turbo",
      "url": "https://api.openai.com/v1/chat/completions",
      "api_key": "your-api-key-here"
    }
  }
}

Troubleshooting

If you encounter issues during installation:

1. Rust Build Failures

   • Verify your Rust installation: rustc --version

   • Ensure WebAssembly target is installed: rustup target list

2. Node.js Issues

   • Check Node.js version: node --version

   • Verify npm installation: npm --version

3. Permission Issues

   • Ensure build script is executable

   • Check filesystem permissions

Getting Help

If you need assistance:

• Check the GitHub repository

• Submit issues for bugs or questions

• Contribute via pull requests

---

WASP is an open-source project maintained by the UOMI team. For additional support or information, refer to the project documentation or reach out to the community.