This is a LoomAI weave — a reusable slice template designed for LoomAI, the AI-assisted browser-based sandbox for designing, deploying, and managing experiments on the FABRIC testbed.

What This Weave Does

Hello, FABRIC is the simplest possible weave: it provisions a single Ubuntu 22.04 VM on the FABRIC testbed, confirms it's reachable, and tears it down when you're done. Simple enough to understand at a glance, yet it follows the exact same patterns used by complex multi-node topologies — making it the ideal starting point for new FABRIC users and weave authors alike.

What You'll Learn

This weave is a working reference for key patterns you'll use in every FABRIC experiment:

• Slice lifecycle management — creating, submitting, waiting for readiness, and deleting slices with FABlib
• Progress markers — using ### PROGRESS: lines so the LoomAI UI shows real-time status
• Signal handling — trapping SIGTERM/SIGINT for clean teardown when you click Stop
• Auto site selection — finding a FABRIC site with available capacity at runtime
• Shell + Python integration — orchestrating FABlib from a shell script via a Python helper

Interactive Notebook

The included Jupyter notebook (hello_fabric.ipynb) walks through the same workflow step by step — create a slice, inspect the node, run a command over SSH, and clean up. Open it in JupyterLab to experiment interactively and build intuition for the FABlib API before writing your own automation.

Weave Structure

This weave's file organization serves as a template for building your own:

Building Your Own Weaves

Use this weave as a starting template: copy the directory, rename it, and modify the topology in weave.json to add more nodes, networks, or components. The shell script and Python helper show the patterns you'll need — progress reporting, error handling, and graceful shutdown. Ask the AI assistant to /create-weave based on this structure to scaffold a new weave automatically.

How to Use

1. Click Run on the weave card in LoomAI
2. Enter a slice name (or keep the default hello-fabric)
3. Wait for provisioning — the weave automatically selects an available site
4. Your VM is ready! SSH in from the slice view or run commands directly
5. Click Stop to tear down the slice when you're done

Installing LoomAI

LoomAI requires Docker with Compose v2. Install and run with a single command:

curl -fsSL https://raw.githubusercontent.com/fabric-testbed/loomai/main/install.sh | bash

Then open http://localhost:3000 in your browser. For more details, visit the LoomAI GitHub repository: https://github.com/fabric-testbed/loomai