Detailed Installation Guide
Comprehensive installation instructions for MetaPilot across Linux, macOS, and Windows environments.
System Prerequisites
| Dependency | Minimum Version | Recommended Version | Purpose |
|---|---|---|---|
| Node.js | v18.0.0 | v20.x LTS | Next.js 16 Frontend Runtime |
| Yarn | v1.22.x | v1.22.22 | Node Package Manager |
| Python | v3.11.0 | v3.14.x / v3.11.x | Django 5.0 Backend API |
| Redis | v6.2.0 | v7.2.x | Celery Broker & Channels Layer |
| PostgreSQL (Prod) | v14.0 | v16.x | Production Relational Database |
| Git | v2.30.0 | Latest | Source Control |
Linux (Fedora / Ubuntu / Debian) Setup
1. Install System Packages
Ubuntu / Debian:
bash
sudo apt update
sudo apt install -y python3 python3-venv python3-pip nodejs redis-server postgresql postgresql-contrib
Fedora / RHEL:
bash
sudo dnf install -y python3 python3-pip nodejs redis postgresql-server
2. Verify Redis Service
bash
sudo systemctl enable --now redis
redis-cli ping # Should return PONG
macOS Setup (Homebrew)
bash
brew update
brew install node yarn python@3.11 redis postgresql@16
brew services start redis
Windows Setup (WSL2 Recommended)
For best performance and full WebSocket / Redis compatibility on Windows, run MetaPilot inside WSL2 (Windows Subsystem for Linux) with Ubuntu.
powershell
# In PowerShell (Admin)
wsl --install -d Ubuntu
Once inside WSL2, follow the Linux setup steps above.
Repository Verification Command
Run the test runner script to verify your local installation:
bash
cd services/api
python manage.py test
If 0 system check issues are returned, your environment is correctly configured!