Quick Start

This guide will help you set up Gambiarra and start sharing LLMs on your network.

Installation

CLI

The CLI allows you to start hubs, create rooms, and join as a participant.

Via curl (recommended):

curl -fsSL https://raw.githubusercontent.com/arthurbm/gambiarra/main/scripts/install.sh | bash

Via npm:

npm install -g gambiarra

Via bun:

bun add -g gambiarra

SDK

The SDK provides Vercel AI SDK integration for using shared LLMs in your applications.

npm install gambiarra-sdk
# or
bun add gambiarra-sdk

Basic Usage

1. Start the Hub Server

gambiarra serve --port 3000 --mdns

2. Create a Room

gambiarra create
# Output: Room created! Code: ABC123

3. Join with Your LLM

gambiarra join ABC123 \
  --endpoint http://localhost:11434 \
  --model llama3 \
  --nickname joao

4. Use the SDK

import { createGambiarra } from "gambiarra-sdk";
import { generateText } from "ai";

const gambiarra = createGambiarra({
  roomCode: "ABC123",
  hubUrl: "http://localhost:3000",
});

const result = await generateText({
  model: gambiarra.any(),
  prompt: "Hello, Gambiarra!",
});

console.log(result.text);

Next Steps

• Learn about CLI commands
• Explore SDK usage