Summary

Bubble Lab is an open-source, AI-native platform for building agentic workflows, designed for developers seeking control and transparency. It addresses the limitations of proprietary workflow builders by compiling flows into production-ready TypeScript, offering full observability and exportability.

How It Works

The platform utilizes a "composable bubble system" where integrations, tools, and logic nodes are chained together. Workflows can be initiated via natural language prompts, translated into TypeScript by an AI assistant (Pearl), and then exported as clean, runnable TypeScript code. This approach provides full control over the workflow logic and deployment.

Quick Start & Requirements

• Hosted Bubble Studio: The fastest way to start, requiring no setup. Access via https://app.bubblelab.ai/.
• Local Development: Install dependencies with pnpm install and run with pnpm run dev. Alternatively, scaffold a new project using npx create-bubblelab-app, then cd my-agent, npm install, and npm run dev.
• Prerequisites: For building from source, Bun, pnpm, and Node.js v18+ are required.
• API Keys: AI-powered flow generation necessitates GOOGLE_API_KEY and OPENROUTER_API_KEY. Other optional keys include OPENAI_API_KEY, RESEND_API_KEY, FIRE_CRAWL_API_KEY, and Clerk keys for production authentication.
• Links: Documentation: https://docs.bubblelab.ai/intro. Demos: https://www.bubblelab.ai/demos.

Highlighted Details

• Prompt to Workflow: Describe desired functionality in natural language to auto-generate workflows.
• Full Observability: Built-in execution tracing, detailed logs, token usage, and performance metrics for debugging.
• Import from n8n: Seamless migration of existing workflows via automatic JSON translation.
• Export as TypeScript: Full ownership of workflows as clean, production-ready TypeScript code for integration into any environment.
• Type-Safe: Leverages TypeScript for robust development and predictable execution.

Maintenance & Community

• Community: Discord server available at https://discord.com/invite/PkJvcU2myV.
• CI Status: Monitored via GitHub Actions: https://github.com/bubblelabai/BubbleLab/actions/workflows/ci.yml.
• Contribution/Self-Hosting: Documentation is noted as "coming soon."

Licensing & Compatibility

• License: Apache 2.0.
• Compatibility: The Apache 2.0 license permits commercial use and integration into closed-source projects.

Limitations & Caveats

AI-driven workflow generation is contingent on configuring specific API keys (GOOGLE_API_KEY, OPENROUTER_API_KEY); otherwise, AI features are disabled. Documentation for contributing and self-hosting is still under development. Local development defaults to SQLite and mock authentication, requiring configuration for production environments.