Skip to main content

​
Installation

Weaver can be installed in multiple ways depending on your needs. Choose the method that works best for your environment. Docker is the easiest way to get started with Weaver, providing consistent environments and easy updates.
1
Pull the Image
2
Get the latest Weaver image from Docker Hub:
3
docker pull operatoronline/weaver:latest
4
Initialize Configuration
5
Create your Weaver home directory and configuration:
6
docker run --rm -v ~/.weaver:/root/.weaver operatoronline/weaver onboard
7
Verify Installation
8
Check that Weaver is working:
9
docker run --rm operatoronline/weaver version
10
You should see output like:
11
🕸️ weaver v1.0.0
  Build: 2026-03-01T10:00:00Z
  Go: go1.26.0
The Docker image is built with a multi-stage process, resulting in a minimal runtime image (~50MB) with only essential dependencies.

​
Pre-built Binaries

Download pre-compiled binaries for your platform from the releases page. 
# Download latest release
curl -L -o weaver.tar.gz https://github.com/operatoronline/weaver/releases/latest/download/weaver-linux-amd64.tar.gz

# Extract
tar xzf weaver.tar.gz

# Move to PATH
sudo mv weaver /usr/local/bin/

# Verify
weaver version

​
Initialize After Binary Install

Once the binary is installed, initialize your configuration: 
weaver onboard
This creates:
  • ~/.weaver/config.json - Configuration file
  • ~/.weaver/workspace/ - Agent workspace directory

​
Build from Source

For development or customization, build Weaver from source.
1
Prerequisites
2
Ensure you have:
3
  • Go 1.21 or later
  • Git
  • Make (optional, for convenience)
    • 4
    go version  # Should be 1.21+
    5
    Clone the Repository
    6
    git clone https://github.com/operatoronline/weaver.git
cd weaver
    7
    Install Dependencies
    8
    Download Go module dependencies:
    9
    go mod download
    10
    Build the Binary
    11
    Using Make
    make build

# Binary will be at ./build/weaver
./build/weaver version
    Manual Build
    go build -o weaver ./cmd/weaver

# Run the binary
./weaver version
    With Version Info
    VERSION=$(git describe --tags --always)
GIT_COMMIT=$(git rev-parse --short HEAD)
BUILD_TIME=$(date -u '+%Y-%m-%dT%H:%M:%SZ')

go build -ldflags "\
  -X main.version=${VERSION} \
  -X main.gitCommit=${GIT_COMMIT} \
  -X main.buildTime=${BUILD_TIME}" \
  -o weaver ./cmd/weaver
    12
    Install Locally
    13
    Move the binary to your PATH:
    14
    sudo mv ./build/weaver /usr/local/bin/
# or
sudo mv ./weaver /usr/local/bin/
    15
    Initialize Configuration
    16
    weaver onboard

    ​
    Docker Build

    Build your own Docker image from source: 
    # Clone the repository
git clone https://github.com/operatoronline/weaver.git
cd weaver

# Build the image
docker build -t weaver:local .

# Run it
docker run --rm weaver:local version

    ​
    Dockerfile Overview

    The multi-stage Dockerfile ensures minimal image size: 
    FROM golang:1.26.0-alpine AS builder

RUN apk add --no-cache git make
WORKDIR /src

# Cache dependencies
COPY go.mod go.sum ./
RUN go mod download

# Build binary
COPY . .
RUN make build

    ​
    Post-Installation

    ​
    Configure API Keys

    Edit your configuration file to add API keys: 
    nano ~/.weaver/config.json
    Add your preferred provider: 
    {
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-your-key-here"
    },
    "gemini": {
      "api_key": "your-gemini-key"
    }
  },
  "agents": {
    "defaults": {
      "model": "google/gemini-flash-1.5"
    }
  }
}

    ​
    Verify Installation

    Check your installation status: 
    weaver status
    Expected output: 
    🕸️ weaver Status
Version: v1.0.0

Config: /home/user/.weaver/config.json ✓
Workspace: /home/user/.weaver/workspace ✓
Model: google/gemini-flash-1.5
OpenRouter API: ✓
Gemini API: ✓

    ​
    Test Your Installation

    Run a simple query: 
    weaver agent -m "Hello, world!"

    ​
    Available Commands

    Weaver provides several commands: 
    # Interactive mode
weaver agent

# One-shot query
weaver agent -m "Your message"

# Custom session
weaver agent -s "project-alpha" -m "Status update"

# Debug mode
weaver agent --debug -m "Test"

    ​
    Updating Weaver

    # Pull latest image
docker pull operatoronline/weaver:latest

# Restart your containers
docker compose down
docker compose up -d

    ​
    Uninstalling

    This will remove all configuration and workspace data. Make sure to back up any important data first.
    # Remove containers
docker compose down -v

# Remove image
docker rmi operatoronline/weaver

# Remove data
rm -rf ~/.weaver

    ​
    Next Steps

    Quickstart

    Get started with your first agent

    Configuration

    Customize your Weaver setup

    Skills

    Extend capabilities with skills

    Gateway

    Deploy multi-channel gateway

    Build docs developers (and LLMs) love

    Get started for freeTalk to us