Skip to content

Update README.md #55

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+39 −18
Open

Update README.md #55

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d3aac20
Update README.md
DragonSenseiGuy Aug 14, 2025
b862f47
Merge branch 'main' into patch-1
DragonSenseiGuy Aug 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 39 additions & 18 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,40 +1,61 @@
# Open Lovable

Chat with AI to build React apps instantly. An example app made by the [Firecrawl](https://firecrawl.dev/?ref=open-lovable-github) team. For a complete cloud solution, check out [Lovable.dev ❤️](https://lovable.dev/).
**Instantly build React apps by chatting with AI.**
Created by the [Firecrawl](https://firecrawl.dev/?ref=open-lovable-github) team.
For a complete cloud solution, check out [Lovable.dev ❤️](https://lovable.dev/).

<img src="https://media1.giphy.com/media/v1.Y2lkPTc5MGI3NjExbmZtaHFleGRsMTNlaWNydGdianI4NGQ4dHhyZjB0d2VkcjRyeXBucCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/ZFVLWMa6dVskQX0qu1/giphy.gif" alt="Open Lovable Demo" width="100%"/>
<p align="center">
<img src="https://media1.giphy.com/media/v1.Y2lkPTc5MGI3NjExbmZtaHFleGRsMTNlaWNydGdianI4NGQ4dHhyZjB0d2VkcjRyeXBucCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/ZFVLWMa6dVskQX0qu1/giphy.gif" alt="Open Lovable Demo" width="100%" />
</p>

---

## 🚀 Features
- **Natural Language to Code** – Describe what you want, get a working React app instantly.
- **Multiple AI Providers** – OpenAI, Anthropic, Gemini, Groq, and more.
- **Integrated Web Scraping** – Powered by Firecrawl for real-time data.
- **Sandboxed Execution** – Safe, isolated environments via E2B.

## Setup
---

1. **Clone & Install**
## 🛠 Setup

### 1️⃣ Clone & Install
```bash
git clone https://github.com/mendableai/open-lovable.git
cd open-lovable
npm install
```
````

### 2️⃣ Configure Environment

Create a `.env.local` file in the root directory:

2. **Add `.env.local`**
```env
# Required
E2B_API_KEY=your_e2b_api_key # Get from https://e2b.dev (Sandboxes)
FIRECRAWL_API_KEY=your_firecrawl_api_key # Get from https://firecrawl.dev (Web scraping)

# Optional (need at least one AI provider)
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 - Kimi K2 recommended)
E2B_API_KEY=your_e2b_api_key # https://e2b.dev (Sandboxes)
FIRECRAWL_API_KEY=your_firecrawl_api_key # https://firecrawl.dev (Web scraping)

# Optional – at least one AI provider required
OPENAI_API_KEY=your_openai_api_key # https://platform.openai.com (GPT-5)
ANTHROPIC_API_KEY=your_anthropic_api_key # https://console.anthropic.com
GEMINI_API_KEY=your_gemini_api_key # https://aistudio.google.com/app/apikey
GROQ_API_KEY=your_groq_api_key # https://console.groq.com (Fast inference - Kimi K2 recommended)
```

3. **Run**
> 💡 You only need **one AI provider** to get started.

### 3️⃣ Run the App

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000)
Open [http://localhost:3000](http://localhost:3000) in your browser.

---

## 📜 License

## License
MIT – See the [LICENSE](LICENSE) file for details.

MIT