open-lovable README

The project's README from github.com/firecrawl/open-lovable. As one markdown file: README.md.

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 ❤️.

Open Lovable Demo

Setup

  1. Clone & Install
git clone https://github.com/firecrawl/open-lovable.git
cd open-lovable
pnpm install  # or npm install / yarn install
  1. Add .env.local
# =================================================================
# REQUIRED
# =================================================================
FIRECRAWL_API_KEY=your_firecrawl_api_key    # https://firecrawl.dev

# =================================================================
# AI PROVIDER - Choose your LLM
# =================================================================
GEMINI_API_KEY=your_gemini_api_key        # https://aistudio.google.com/app/apikey
ANTHROPIC_API_KEY=your_anthropic_api_key  # https://console.anthropic.com
OPENAI_API_KEY=your_openai_api_key        # https://platform.openai.com
GROQ_API_KEY=your_groq_api_key            # https://console.groq.com

# =================================================================
# FAST APPLY (Optional - for faster edits)
# =================================================================
MORPH_API_KEY=your_morphllm_api_key    # https://morphllm.com/dashboard

# =================================================================
# SANDBOX PROVIDER - Choose ONE: Vercel (default) or E2B
# =================================================================
SANDBOX_PROVIDER=vercel  # or 'e2b'

# Option 1: Vercel Sandbox (default)
# Choose one authentication method:

# Method A: OIDC Token (recommended for development)
# Run `vercel link` then `vercel env pull` to get VERCEL_OIDC_TOKEN automatically
VERCEL_OIDC_TOKEN=auto_generated_by_vercel_env_pull

# Method B: Personal Access Token (for production or when OIDC unavailable)
# 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

# Option 2: E2B Sandbox
# E2B_API_KEY=your_e2b_api_key      # https://e2b.dev
  1. Run
pnpm dev  # or npm run dev / yarn dev

Open http://localhost:3000

License

MIT

open-lovable (firecrawl/open-lovable)

Searching Database…

What is this?Open Lovable is a chat-driven tool that lets you point it at any website and have an AI rebuild it as a modern React app in seconds. It's an open-source example app built by the Firecrawl team to show off AI-powered site cloning.
Is this a hosted product or something I run myself?It's a self-hosted Next.js example app you clone and run on your own machine, not a managed service. For a fully managed cloud version of the same idea, the README points to Lovable.dev.
How do I get it running?Clone the repository, install dependencies, add your API keys to a .env.local file, then start the dev server.
What API keys do I need to set up?You need a Firecrawl API key to scrape the target website, an E2B API key for the sandboxed code execution that previews the generated React app, and a key for at least one AI provider (Anthropic, OpenAI, Google Gemini, or Groq).
Is this the same thing as Lovable.dev?No, this is a smaller open-source demo built by the Firecrawl team to show the concept, not Firecrawl's or Lovable's full commercial product.
How does it actually turn a website into React code?It uses Firecrawl to scrape and parse the target site's structure and content, then an AI model generates equivalent React components, which run and render via an E2B sandboxed code interpreter.
Which AI models can I use?The project ships with AI SDK integrations for Anthropic Claude, OpenAI, Google Gemini, and Groq, so you can pick whichever provider you have a key for.
What UI components does the generated app use?It relies on Radix UI primitives (accordion, dialog, checkbox, avatar, etc.) as the building blocks for the React apps it generates.
What are similar projects?dyad, NextChat, ai, mike, openui, quivr, trueforge, LibreChat
Creator
firecrawl
Size
0.7 MB
Stars
28.7K
Updated
CommitOct 09
Age
1y
Commits · 90 Days