forked from elizaOS/eliza
-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
78 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,78 @@ | ||
# WSL Setup Guide | ||
Steps to run Eliza on Windows computer using WSL. | ||
AI Dev School Tutorial: https://www.youtube.com/watch?v=ArptLpQiKfI | ||
|
||
|
||
## Install WSL | ||
|
||
1. Open PowerShell as Administrator and run: | ||
```powershell | ||
wsl --install | ||
``` | ||
|
||
2. Restart your computer | ||
3. Launch Ubuntu from the Start menu and create your Linux username/password | ||
|
||
## Install Dependencies | ||
|
||
1. Update Ubuntu packages: | ||
```bash | ||
sudo apt update && sudo apt upgrade -y | ||
``` | ||
|
||
2. Install system dependencies: | ||
```bash | ||
sudo apt install -y \ | ||
build-essential \ | ||
python3 \ | ||
python3-pip \ | ||
git \ | ||
curl \ | ||
ffmpeg \ | ||
libtool-bin \ | ||
autoconf \ | ||
automake \ | ||
libopus-dev | ||
``` | ||
|
||
3. Install Node.js via nvm: | ||
```bash | ||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash | ||
source ~/.bashrc | ||
nvm install 20 | ||
nvm use 20 | ||
``` | ||
|
||
4. Install pnpm: | ||
```bash | ||
curl -fsSL https://get.pnpm.io/install.sh | sh - | ||
source ~/.bashrc | ||
``` | ||
|
||
## Optional: CUDA Support | ||
|
||
If you have an NVIDIA GPU and want CUDA support: | ||
|
||
1. Install CUDA Toolkit on Windows from [NVIDIA's website](https://developer.nvidia.com/cuda-downloads) | ||
2. WSL will automatically detect and use the Windows CUDA installation | ||
|
||
## Clone and Setup Eliza | ||
|
||
Follow the [Quickstart Guide](./quickstart.md) starting from the "Installation" section. | ||
|
||
## Troubleshooting | ||
|
||
- If you encounter `node-gyp` errors, ensure build tools are installed: | ||
```bash | ||
sudo apt install -y nodejs-dev node-gyp | ||
``` | ||
|
||
- For audio-related issues, verify ffmpeg installation: | ||
```bash | ||
ffmpeg -version | ||
``` | ||
|
||
- For permission issues, ensure your user owns the project directory: | ||
```bash | ||
sudo chown -R $USER:$USER ~/path/to/eliza | ||
``` |