This guide will help you set up the Eliza framework. We'll walk through installing all prerequisites and then launching Eliza.
WSL2 is required for Windows installations. Please follow the Microsoft WSL installation guide before proceeding with the setup.
- Python 2.7+
- Node.js 23+
- PNPM
Most Linux distributions come with Python pre-installed. To verify and install:
# Check Python version
python --version
python3 --version
# Install Python 3.13
sudo apt-get update
sudo apt-get install python3.13Install Python using Homebrew:
# Install Python
brew install python3
# Verify installation
python3 --version# Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# Configure shell
source ~/.bashrc
# Install Node.js
nvm install 23
# Verify installation
node -v
npm -vNode.js can be installed using NVM (Node Version Manager):
# Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# Configure shell (choose appropriate command)
source ~/.bashrc # For bash users
source ~/.zshrc # For zsh users
# Install Node.js
nvm install 23
# Verify installation
node -vPNPM is a performant package manager that saves disk space compared to npm.
npm install -g pnpmgit clone https://github.com/elizaos/eliza-starter.git
cd eliza-starter
cp .env.example .env
pnpm i && pnpm build && pnpm start# Clone the repository
git clone https://github.com/elizaos/eliza.git
# Checkout latest release
git checkout $(git describe --tags --abbrev=0)
# Alternative checkout command if above doesn't work:
# git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
# Configure environment
cp .env.example .env
# Install dependencies and start
pnpm i
pnpm build
pnpm start
# Clean project if needed
pnpm cleanOnce the agent is running:
- Open a new terminal
- Navigate to the project directory
- Run
pnpm start:client - Follow the URL provided to chat with your agent
Here's what you'll see after successfully running Eliza:
You can interact with Eliza on the terminal.
Eliza begins engaging with you, showing its interactive capabilities.