A simple clone of lovable.dev, beam-cloud/lovable-clone demonstrates building an AI-powered web application builder using BAML, FastMCP, and Beam's cloud infrastructure. It targets developers seeking a rapid prototyping tool for web apps, offering real-time code generation and sandboxed execution environments to accelerate development workflows.

How It Works

The architecture consists of three main components: a Model Client that communicates with LLMs via BAML, a compute sandbox on Beam for running React previews, and a WebSocket-based Agent that streams user edit requests. This design leverages sandboxing for safe execution and BAML for efficient prompt management and client generation, enabling real-time updates within isolated environments.

Quick Start & Requirements

• Installation: Clone the repository, install Python dependencies (pip install -r requirements.txt), and frontend dependencies (npm install within the frontend directory).
• Prerequisites: Python 3.12+, Node.js 20+, an OpenAI API key, and a Beam account are required.
• Setup: Create secrets using beam secret create OPENAI_API_KEY 'your-openai-api-key'. Configure the frontend .env file with VITE_BEAM_WS_URL (obtained from beam serve) and VITE_BEAM_TOKEN (from Beam platform settings).
• Usage: Start the agent with beam serve src/agent.py:handler and run the frontend development server with npm run dev in the frontend directory.
• Links: OpenAI API key: https://platform.openai.com/api-keys, Beam token: https://platform.beam.cloud/settings/api-keys.

Highlighted Details

• Features a real-time AI-powered web application builder inspired by lovable.dev.
• Utilizes BAML for defining and generating AI prompts and client code, with prompts managed in baml_src/build.baml.
• Employs a sandboxed environment with a Node.js 20 base image, running a React + Vite + shadcn/ui template.

Maintenance & Community

No specific details regarding contributors, community channels (e.g., Discord, Slack), or roadmap are provided in the README.

Licensing & Compatibility

The repository's license is not explicitly stated in the README. This omission requires clarification for assessing commercial use or closed-source linking compatibility.

Limitations & Caveats

Described as a "simple clone" and a "demonstration," the project may not possess the full feature set or production-readiness of the original lovable.dev. Specific limitations or unsupported platforms are not detailed.