whatisgithub

What is gaffer?

edycutjong/gaffer — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A hackathon project that generates offline football commentary by borrowing spare computing power from a nearby laptop over encrypted peer to peer networking.

Mindmap

mindmap
  root((repo))
    What it does
      Runs AI commentary offline
      Offloads to peer laptop
      Resumes if peer drops
    Tech stack
      Node.js
      QVAC SDK
      Pear Hyperswarm
      Hyperdrive
    Use cases
      Offline match commentary
      Peer to peer compute offload
      Hackathon demo
    Audience
      Hackathon judges
      Developers
      P2P enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run offline AI commentary on a weak phone by borrowing a laptop's compute over a P2P link.

USE CASE 2

Study a working example of encrypted peer to peer inference offload with automatic failover.

USE CASE 3

Demo or judge the project as a hackathon submission for the Tether Developers Cup.

What is it built with?

JavaScriptNode.jsQVACPearHyperswarm

How does it compare?

edycutjong/gaffer00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultymoderateeasyhard
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Full AI commentary requires installing the @qvac/sdk and downloading a model, otherwise it runs with a disclosed simulated engine.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and any stated changes.

So what is it?

Gaffer is a hackathon project that generates spoken football match commentary entirely offline, without relying on any cloud service or API key. The idea it tackles is that expert commentary usually stops working the moment a phone loses its internet connection, and the fans who most need a simplified explanation of the game often have the weakest phones. Gaffer's answer is to run an AI model directly on a person's own device, and when that device is too weak to keep up, it borrows spare computing power from a nearby laptop over a direct, encrypted peer to peer connection, with no server in between. The project was built for a hackathon called the Tether Developers Cup, in the track combining two technologies: QVAC, which runs AI models on device, and Pear, a peer to peer networking stack built on Hyperswarm and Hyperdrive. In practice, a weak client device streams commentary at only a few tokens per second on its own, but once a laptop peer joins the same match session, that speed jumps dramatically because the laptop takes over the heavy computation while the phone still displays the result. If the laptop disconnects mid sentence, the phone finishes that sentence locally without losing its place. The README is notably transparent about what parts of the demo are real versus simulated: the peer to peer networking, encryption, and failover logic are described as genuinely real and covered by automated tests, including tests that run the actual peer to peer stack rather than mocks. The AI text generation and voice synthesis are real only when the QVAC software development kit is installed, otherwise the project falls back to a clearly labeled fake text generator so the networking and offload behavior can still be demonstrated on any machine. The underlying football match events themselves come from a simulated, seeded data feed rather than a licensed real data source. Gaffer is written in JavaScript, requires Node.js version 20 or newer, includes 220 automated tests, and is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Walk me through cloning Gaffer and running it in standalone judge mode.
Prompt 2
Explain how Gaffer's provider and client terminals connect and offload inference to each other.
Prompt 3
What happens in Gaffer's failover state machine when the peer laptop disconnects mid sentence?
Prompt 4
Which parts of Gaffer's demo are real versus simulated, and why does that distinction matter?
Prompt 5
Help me run Gaffer's benchmark and interpret the local versus offloaded tokens per second numbers.

Frequently asked questions

What is gaffer?

A hackathon project that generates offline football commentary by borrowing spare computing power from a nearby laptop over encrypted peer to peer networking.

What language is gaffer written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, QVAC.

What license does gaffer use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and any stated changes.

How hard is gaffer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gaffer for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.