Download & Install

Run Bloom locally on your computer.

Option 1: Web Playground

The easiest way to use Bloom is the online playground. No installation required.

Option 2: Run Locally

For a local development environment with hot reloading:

Prerequisites

• Node.js (version 18 or later)
• Git

Installation

# Clone the repository
git clone https://github.com/your-username/bloom.git
cd bloom

# Install dependencies
npm install

# Start development server
npm run dev

Then open http://localhost:5173 in your browser.

Option 3: VS Code Extension

Get syntax highlighting and autocomplete for .bloom files in VS Code.

Install from Source

# Build the language server
cd lsp && npm install && npm run build && cd ..

# Build the VS Code extension
cd vscode-extension && npm install && npm run compile

# Create symlink to VS Code extensions folder
ln -s "$(pwd)" ~/.vscode/extensions/bloom-language

Features

• Syntax highlighting for keywords, functions, colors
• Autocomplete for built-in functions
• Code snippets (type sketch, for, circle)
• Hover documentation

Option 4: Python Runtime

Run Bloom programs in Python with pygame for desktop apps:

# Install pygame
pip install pygame

# Run a Bloom file
python python/bloom_runtime.py examples/hello.bloom

Export Your Work

From the playground, you can export your sketches as:

• HTML - Standalone web page that runs anywhere
• PNG - Static image of current frame
• GIF - Animated loop of your sketch
• .bloom - Source code file