FABRIC Jupyter Notebook Examples

A curated collection of 80 Jupyter notebooks that serve as a comprehensive guide to using the FABRIC testbed and the FABlib API. These examples are designed to run on the FABRIC JupyterHub environment or locally with FABlib installed.

Getting Started

Open start_here.ipynb for a guided index with clickable links to all included notebooks. All relative paths are preserved, so links work directly after extraction.

What's Included

Basics

• Environment configuration and validation
• Hello FABRIC — your first slice
• Artifact Manager usage
• Resource discovery and site filtering
• Slice creation, modification, deletion, renewal, and sharing

Compute & Storage

• Node customization (cores, RAM, disk, images)
• GPU provisioning (Tesla T4, RTX6000, A30, A40)
• Local disk, NVMe devices, persistent storage, and distributed shared storage (CephFS)
• Storage benchmarking

Networking

• Layer 2: Local Ethernet, wide-area links, sub-interfaces, port mirroring
• Layer 3: FABNetv4, FABNetv6, with and without external access
• Facility ports (e.g., Chameleon integration)
• FRRouting OSPF, Open vSwitch, DPDK with Smart NICs
• iPerf3 performance testing with CPU pinning and NUMA tuning
• One-Way Latency (OWL) measurements

Programmable Hardware

• P4 switches (Tofino)
• FPGAs (Xilinx U280, ESnet P4 workflow)
• BlueField DPUs

Complex Recipes & Applications

• Kubernetes cluster deployment
• Docker container setup
• Grafana/Prometheus monitoring
• Tailscale mesh VPN
• Collaborative slices with Ollama LLM inference
• Pegasus Workflow Management System
• P4 Labs (BMv2) tutorial series
• PEERING client setup and BGP peering

Usage

tar xzf jupyter-examples.tar.gz
  # Open start_here.ipynb in Jupyter to browse all examples

For more information, visit the jupyter-examples GitHub repository.