Open Lovable

Chat with AI to build React apps instantly. An example app made by the Firecrawl team. For a complete cloud solution, check out Lovable.dev ❤️.

Supports both E2B and Vercel sandboxes for code execution. Choose your preferred sandbox provider in the setup below.

Setup

Clone & Install

git clone https://github.com/mendableai/open-lovable.git
cd open-lovable
pnpm install  # or npm install / yarn install

Add .env.local

# Required
FIRECRAWL_API_KEY=your_firecrawl_api_key  # Get from https://firecrawl.dev (Web scraping)

# =================================================================
# SANDBOX PROVIDER - Choose ONE: E2B or Vercel
# =================================================================

# Optional: Specify sandbox provider (defaults to 'e2b' if not set)
# SANDBOX_PROVIDER=e2b  # or 'vercel'

# -----------------------------------------------------------------
# OPTION 1: E2B Sandbox
# -----------------------------------------------------------------
# Get your API key from: https://e2b.dev
E2B_API_KEY=your_e2b_api_key

# -----------------------------------------------------------------
# OPTION 2: Vercel Sandbox
# -----------------------------------------------------------------
# Method 1: OIDC Token (automatic setup)
# Run `vercel link` then `vercel env pull` to get VERCEL_OIDC_TOKEN automatically
# VERCEL_OIDC_TOKEN=auto_generated_by_vercel_env_pull

# Method 2: Personal Access Token (manual setup)
# VERCEL_TEAM_ID=team_xxxxxxxxx      # Your Vercel team ID
# VERCEL_PROJECT_ID=prj_xxxxxxxxx    # Your Vercel project ID
# VERCEL_TOKEN=vercel_xxxxxxxxxxxx   # Personal access token from Vercel dashboard
# See: https://vercel.com/docs/vercel-sandbox#authentication

# =================================================================
# AI PROVIDERS - Add at least one
# =================================================================
ANTHROPIC_API_KEY=your_anthropic_api_key  # Get from https://console.anthropic.com
OPENAI_API_KEY=your_openai_api_key        # Get from https://platform.openai.com (GPT-5)
GEMINI_API_KEY=your_gemini_api_key        # Get from https://aistudio.google.com/app/apikey
GROQ_API_KEY=your_groq_api_key            # Get from https://console.groq.com (Fast inference)

Run

pnpm dev  # or npm run dev / yarn dev

Open http://localhost:3000

Sandbox Providers

Open Lovable supports two sandbox providers for code execution:

🔧 E2B

Full-featured development environment with Node.js, npm, and pre-installed tools
Persistent file system across interactions
Fast startup and reliable performance
Advanced debugging capabilities
Perfect for complex applications and debugging

⚡ Vercel

Vercel-hosted sandboxes with automatic scaling
Integrated with Vercel ecosystem for seamless deployment
Automatic OIDC authentication (run vercel link then vercel env pull)
Great for production workflows and Vercel users

Choosing Your Provider

Use E2B if you need full development capabilities and debugging features
Use Vercel if you're already in the Vercel ecosystem or prefer their hosted solution
Default: E2B (if no SANDBOX_PROVIDER is specified)

You can switch providers anytime by updating the SANDBOX_PROVIDER environment variable.

License

MIT

3.6 KiB Raw Blame History