gitwtfhub

wtf is loomprotocol?

projectpaie/loomprotocol — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 5/5LicenseSetup · hard

TL;DR

A peer to peer system that splits large text jobs into small pieces and processes them across your own networked computers, using two local models in sequence to draft and refine each piece.

Mindmap

mindmap
  root((repo))
    What it does
      Shards large documents
      Distributes to home computers
      Draft plus critique loop
    Tech stack
      Python
      Ollama
      llama.cpp
      Postgres ledger
    Use cases
      Distributed translation
      Local text processing
      Privacy preserving sharding
    Audience
      Developers with spare hardware
      Privacy focused users

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

Why would anyone build with this?

REASON 1

Translate or process a very large document by spreading the work across several home computers instead of one machine

REASON 2

Run a two model draft and critique pipeline to catch errors before finalizing text output

REASON 3

Process sensitive documents locally so no single outside server ever sees the whole text

REASON 4

Turn a spare consumer machine, like an old Windows PC with a graphics card, into a worker node for text processing jobs

What's in the stack?

PythonOllamallama.cppPostgreSQL

How it stacks up

projectpaie/loomprotocol0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs multiple networked machines each running a local LLM engine like Ollama or llama.cpp to see any benefit.

Free to use and modify, but any hosted or commercial service built on it must display a notice telling users the software is free open source, under the AGPLv3 copyleft license.

Wtf does this do

Loom Protocol is a local first, peer to peer system for breaking a large text processing job into small pieces and spreading that work across ordinary computers on a network, rather than relying on one big server or cloud service. It follows a hub and spoke layout: one coordinator computer, called the hub, splits a document into shards and puts them in a queue, while other computers on the network, called spokes, pull shards from that queue, run them through a local language model, and send back the finished piece. For each shard, two separate local models work in sequence rather than just one. The first model produces a draft, for example an English translation of a passage. The second model reviews that draft for accuracy, tone, and any missing nuance, and a final step folds the review into a corrected version, which then gets recorded along with which machine and which model produced it. Because each spoke only ever receives one small, disconnected piece of a larger document, no single computer or outside model provider sees enough of the whole text to reconstruct it. The README demonstrates the system with a real test: translating a full classic Japanese novel using one Mac Studio and two Windows PCs with graphics cards, running open local models, which took a little under two hours from start to finish and produced tens of thousands of English words. The project is aimed at people who want to process large amounts of text using hardware they already own instead of paying for cloud computing, and it works over local Wi-Fi or a private VPN like Tailscale. It ships as two Python scripts, one to start the hub server and one to start a worker. It is released under the AGPLv3 license, which requires any hosted service built on it to display a notice telling users the software is free and open source.

Yoink these prompts

Prompt 1
Help me set up a Loom Protocol hub on my main computer and a worker on my other PC
Prompt 2
Explain how Loom Protocol's draft and critique consensus loop works between two models
Prompt 3
Walk me through running loom_worker.py pointed at my Loom hub's IP address
Prompt 4
What does the AGPLv3 notice requirement mean if I want to offer Loom Protocol as a hosted service

Frequently asked questions

wtf is loomprotocol?

A peer to peer system that splits large text jobs into small pieces and processes them across your own networked computers, using two local models in sequence to draft and refine each piece.

What language is loomprotocol written in?

Mainly Python. The stack also includes Python, Ollama, llama.cpp.

What license does loomprotocol use?

Free to use and modify, but any hosted or commercial service built on it must display a notice telling users the software is free open source, under the AGPLv3 copyleft license.

How hard is loomprotocol to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is loomprotocol for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.