create-bubblelab-app

The easiest way to get started with BubbleLab - the AI agent workflow framework.

Usage

Create a new BubbleLab application with one command:

npx create-bubblelab-app

or with your preferred package manager:

# pnpm
pnpm create bubblelab-app

# yarn
yarn create bubblelab-app

# npm
npm create bubblelab-app

What You Get

The CLI will:

1. Prompt you for a project name
2. Let you choose a template (Weather Agent, more coming soon)
3. Set up a complete BubbleLab project with:
   • TypeScript configuration
   • Example AI agent workflow
   • Comprehensive documentation
   • Environment setup guide

Templates

Weather Agent (Recommended)

A complete example showing how to build an AI agent that:

• Uses Google Gemini AI
• Performs web research
• Handles dynamic parameters
• Returns structured results

Perfect for learning BubbleLab basics!

After Creation

cd your-project-name

# Set up your API keys
cp .env.example .env
# Edit .env with your keys

# Run the example
npm run dev

Requirements

• Node.js 18+
• A Google Gemini API key (free tier available)
• A Firecrawl API key for web search

Learn More

• BubbleLab GitHub
• Documentation
• Examples

License

Apache-2.0 © Bubble Lab, Inc.