📋 Download Guide
⚡ Quick Download
MoltBot is distributed via npm (Node Package Manager). Choose your installation method:
NPM (Recommended)
npm install -g MoltBot@latest
Easiest method, automatic updates
GitHub Source
git clone https://github.com/steipete/MoltBot.git
For developers, latest features
Docker
docker pull MoltBot/MoltBot
Containerized deployment
💻 Platform-Specific Downloads
macOS
Requirements
- macOS 12 (Monterey) or later
- Apple Silicon (M1/M2/M3) or Intel
- Node.js 22+ (install via Homebrew)
Installation
# Install Node.js via Homebrew
brew install node
# Install MoltBot
npm install -g MoltBot@latest
# Verify installation
MoltBot --version
Windows
Requirements
- Windows 10/11 (64-bit)
- WSL2 (Windows Subsystem for Linux)
- Node.js 22+
Installation
# Install WSL2 (PowerShell as Admin)
wsl --install
# Inside WSL2 Ubuntu:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install MoltBot
npm install -g MoltBot@latest
Linux
Requirements
- Ubuntu 20.04+, Debian 11+, or equivalent
- Node.js 22+
- systemd (for service management)
Installation
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install MoltBot
npm install -g MoltBot@latest
# Set up as service (optional)
MoltBot service install
Docker
Requirements
- Docker 20.10+
- Docker Compose (optional)
Quick Start
# Pull image
docker pull MoltBot/MoltBot:latest
# Run container
docker run -d \
--name MoltBot \
-v ~/.MoltBot:/root/.MoltBot \
-p 3000:3000 \
MoltBot/MoltBot:latest
📋 System Requirements
Minimum Requirements
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4+ cores |
| RAM | 4GB | 8GB+ |
| Storage | 2GB free | 10GB+ free |
| Node.js | v22.0.0 | Latest LTS |
| Internet | Required for API | Broadband |
For Local AI Models (Ollama)
| Model Size | RAM Required | Recommended Hardware |
|---|---|---|
| 7-8B models | 8GB | M1 Mac, 16GB RAM PC |
| 13B models | 16GB | M2 Pro, 32GB RAM PC |
| 70B models | 48GB+ | Mac Studio, High-end workstation |
See detailed requirements: System Requirements Guide
🔧 Installation Methods Compared
| Method | Difficulty | Best For | Pros | Cons |
|---|---|---|---|---|
| NPM Global | Easy | Most users | Simple, auto-updates | Requires Node.js |
| GitHub Clone | Medium | Developers | Latest features, customizable | Manual updates |
| Docker | Medium | Servers, isolation | Clean, portable | Overhead, complexity |
| Cloud Deploy | Hard | 24/7 availability | Always-on, accessible | Monthly cost |
Recommended Installation Path
- Install Node.js - Download from nodejs.org or use package manager
- Install MoltBot - Run
npm install -g MoltBot@latest - Run Onboarding - Execute
MoltBot onboard - Configure API Keys - Add your Claude/GPT-4 keys
- Connect Messaging - Link Telegram, WhatsApp, etc.
- Start Gateway - Run
MoltBot start
Detailed walkthrough: Complete Installation Guide
🚀 After Installation
1. Initial Configuration
# Run the interactive setup wizard
MoltBot onboard
# This will guide you through:
# - Choosing AI provider (Claude, GPT-4, Gemini, Ollama)
# - Adding API keys
# - Selecting messaging platforms
# - Configuring preferences
2. Connect Messaging Platforms
- Connect Telegram - Most popular, easiest setup
- Connect WhatsApp - QR code pairing
- Connect Discord - Great for communities
3. Choose Your AI Model
- Set up Claude - Best for coding
- Compare AI Models - Find the right fit
- Understand Costs - Budget planning
4. Learn to Use MoltBot
- User Guide - Complete tutorial
- Install Skills - Extend functionality
- Browser Automation - Advanced features
❓ Download FAQ
Do I need to create an account to download MoltBot?
No! MoltBot is open-source. Just install via npm or download from GitHub.
No registration required.
Is MoltBot available on the App Store or Microsoft Store?
No, MoltBot is distributed via npm (Node.js package manager). This gives
you the latest version and easier updates.
Can I install MoltBot without Node.js?
Node.js is required for MoltBot to run. However, you can use the Docker
version which includes all dependencies.
How do I update MoltBot to the latest version?
Run
npm update -g MoltBot to get the latest version. Check
releases at GitHub.Can I run MoltBot on a Raspberry Pi?
Technically yes, but it's not recommended due to performance constraints. A
Mac Mini or old laptop works much better.
Is there a portable version?
MoltBot runs as a Node.js application, so it's inherently portable. You can
copy the installation folder to any compatible system.
What's the download size?
The npm package is ~50MB. With dependencies, total installation is around
200-300MB.