explaingit

swellweb/reame

Analysis updated 2026-05-18

94C++Audience · developerComplexity · 3/5Setup · moderate

TLDR

Reame is an OpenAI-compatible LLM inference server built for cheap CPU hardware that caches prompts and past outputs so repeat requests cost far less.

Mindmap

mindmap
  root((Reame))
    What it does
      CPU-first LLM serving
      Persistent prompt cache
      OpenAI-compatible API
    Tech stack
      C++
      llama.cpp
      GGUF
    Use cases
      Document extraction
      Batch pipelines
      Private code autocomplete
    Features
      Palimpsest archive
      Speculative decoding
      ARCA shared cache

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

Serve a small LLM for document extraction or classification over your own data on a free-tier or shared CPU box.

USE CASE 2

Run overnight batch jobs like tagging thousands of products using Reame's cheap, repeated-prompt caching.

USE CASE 3

Add AI features to a low-margin SaaS product using a cheap VPS instead of a metered API.

USE CASE 4

Point any existing OpenAI client library at Reame's REST API without changing application code.

What is it built with?

C++llama.cppGGUF

How does it compare?

swellweb/reamepancreations/halo-mcc-vrpedrodg28/yuzu-emu
Stars949494
LanguageC++C++C++
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedevelopergeneralgeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Runs on CPU-only hardware including free-tier VPS or ARM boxes, no GPU required.

No license information is stated in the README.

In plain English

Reame is an LLM inference server built on top of llama.cpp and designed specifically for cheap CPU hardware, such as a free tier cloud box, a shared virtual server, or a small 2-core ARM machine, rather than treating CPU as a fallback when a GPU is unavailable. Its guiding idea is that on a CPU, the server should never compute the same thing twice. It is aimed at narrow, repetitive workloads run over your own data on hardware you already have, such as document extraction, batch tagging jobs, private code autocomplete, or adding AI features to a small application without paying for a metered API. It is explicitly not meant as a general chatbot replacement, an agentic coding assistant, or a tool for long creative writing, since those tasks benefit from much larger models than the ones Reame targets. The server's main trick is a persistent cache: prompt prefixes are saved to disk in compressed, checksummed form and reused across different prompts, across restarts, and across separate server processes, so a shared system prompt is only computed once. A related feature called Palimpsest keeps an archive of everything the server has generated before, and can draft new answers from that archive at no extra cost. Another feature speculatively guesses upcoming tokens using either a small draft model or free pattern matching from the prompt itself, and automatically turns this off if measurements show it is not actually helping on the current hardware. An optional consensus mode can generate several candidate answers to the same prompt in one batch and pick the majority answer, which the project describes honestly as reducing random mistakes rather than making a small model reason as well as a larger one. Reame exposes an OpenAI compatible REST API with streaming, sessions, and authentication, so any existing OpenAI client library can point at it, and it includes a simple command line tool that downloads a model and starts chatting with one command. It also offers a separate shared memory service called ARCA that multiple Reame instances can connect to for a shared response cache. The project includes a large automated test suite and publishes its own benchmark numbers, including cases where its approach did not help, on the project's GitHub Pages site.

Copy-paste prompts

Prompt 1
Show me how to install Reame and run a model with the reame run command line tool.
Prompt 2
Explain how Reame's persistent shared-prefix KV cache reduces cost across restarts and processes.
Prompt 3
What kinds of tasks is Reame NOT a good fit for, and why do those need larger models?
Prompt 4
Walk me through setting up the ARCA shared memory daemon to connect multiple Reame nodes.

Frequently asked questions

What is reame?

Reame is an OpenAI-compatible LLM inference server built for cheap CPU hardware that caches prompts and past outputs so repeat requests cost far less.

What language is reame written in?

Mainly C++. The stack also includes C++, llama.cpp, GGUF.

What license does reame use?

No license information is stated in the README.

How hard is reame to set up?

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

Who is reame for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.