🦞
🍎

macOS Installation

Mac / Mac Mini setup guide

Recommended for beginners

Why Mac?

  • • Native Apple Silicon performance
  • • Run Ollama locally for free AI
  • • Perfect "always-on" home server with Mac Mini
  • • No cloud costs - runs on your own hardware

Requirements

macOS Version

12.0+ (Monterey or later)

RAM

8GB+ (16GB for Ollama)

Storage

10GB free space

Processor

Apple Silicon or Intel

Installation Steps

1

Install Homebrew (if not installed)

Homebrew is the package manager for macOS.

$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

Install Node.js

Moltbot requires Node.js 18 or higher.

$brew install node@20
3

Install Moltbot

This will download and set up Moltbot in your home directory.

$curl -fsSL https://molt.bot/install | bash
4

Configure your AI provider

Add your API key for Claude, GPT-4, or set up Ollama.

$moltbot config
5

Start Moltbot

Your personal AI assistant is now running!

$moltbot start

Optional: Run Free with Ollama

Install Ollama to run AI models locally with zero API costs:

Install Ollama:

$brew install ollama

Download a model:

$ollama pull llama3.1

Configure Moltbot to use Ollama:

$moltbot config --provider ollama --model llama3.1
Learn more about Ollama →

Next Steps

Connect Moltbot to your favorite messaging apps.

Browse SkillsTroubleshooting