Skip to main content

Installation

Prerequisites

Before installing Loom, ensure you have:
  • Go 1.21+ - For building from source
  • Beads (bd) - Loom requires Beads for task management
  • Git - For version control operations

Install Beads

Loom requires Beads (bd) to be installed first:
# Install Beads
go install github.com/uttufy/beads/cmd/bd@latest

# Verify installation
bd version
Initialize Beads in your project:
cd your-project
bd init

Install Loom

From Source

# Clone the repository
git clone https://github.com/uttufy/loom.git
cd loom

# Build
go build ./cmd/loom

# Move to PATH (optional)
mv loom /usr/local/bin/

Using Go Install

go install github.com/uttufy/loom/cmd/loom@latest

Verify Installation

loom version

Initialize Configuration

Create a default configuration file:
# Initialize in current directory
loom config init

# Or specify a path
loom config init --config /path/to/loom.yaml
This creates a loom.yaml file with sensible defaults.

Next Steps

Quick Start

Run your first orchestration

Configuration

Customize your setup