Installation¶

This guide covers installing LooK and all required dependencies.

Quick Install¶

npm install -g look-demo

Verify the installation:

look --version  # Should show 2.0.0

System Requirements¶

Node.js 18+¶

LooK requires Node.js 18 or higher.

# Using Homebrew
brew install node

# Using nvm (recommended)
nvm install 18
nvm use 18

# Using nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

# Or using apt (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

Verify:

node --version  # Should be 18.0.0 or higher

FFmpeg¶

FFmpeg is required for video processing.

brew install ffmpeg

# Ubuntu/Debian
sudo apt update
sudo apt install ffmpeg

# Fedora
sudo dnf install ffmpeg

# Arch
sudo pacman -S ffmpeg

Verify:

ffmpeg -version

Playwright Browsers¶

LooK uses Playwright for browser automation. Install the browsers:

npx playwright install chromium

API Keys¶

OpenAI API Key (Required for AI features)¶

LooK uses OpenAI for:

• GPT-4 Vision - Website analysis
• TTS - Voiceover generation

Get your API key at platform.openai.com.

# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export OPENAI_API_KEY=sk-your-key-here

Groq API Key (Optional)¶

For faster script generation, you can use Groq's API:

export GROQ_API_KEY=gsk-your-key-here

Get your key at console.groq.com.

Verify Installation¶

Run the built-in test:

look test

Expected output:

  FFmpeg installed: ✓
  Sharp working: ✓
  Playwright browser: ✓
  OpenAI API key: ✓

✅ All basic tests passed!

For a complete pipeline test:

look test --full

Docker Installation¶

You can also run LooK in Docker:

docker run -p 3847:3847 \
  -e OPENAI_API_KEY=sk-your-key \
  ghcr.io/nirholas/look:latest serve

Troubleshooting¶

"FFmpeg not found"¶

Ensure FFmpeg is in your PATH:

which ffmpeg  # Should show the path

If not found, reinstall using the instructions above.

"Playwright browser not found"¶

npx playwright install chromium

Permission Denied¶

On Linux/macOS, you may need to fix npm permissions:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

More Help¶

See the Troubleshooting Guide for more solutions.

Next Steps¶

Now that LooK is installed, let's create your first demo!