Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 17 additions & 2 deletions docs/lemonade.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@ limitations under the License.
-->
# Lemonade

**The 1bit engine runs inside [Lemonade](https://github.com/lemonade-sdk/lemonade)**, and its
`onebit` recipe passes Lemonade's own LLM test suite on HRX: 31 of 31 tests run, all pass (2 skipped;
**A Strix Halo machine gets its GPU and NPU paths inside [Lemonade](https://github.com/lemonade-sdk/lemonade) from the
1bit engine**, which runs there as Lemonade's `onebit` backend; the `onebit` recipe passes Lemonade's own LLM
test suite on HRX: 31 of 31 tests run, all pass (2 skipped;
2026-11-05). Lemonade
is the server users talk to, with its own catalog, downloads, router and UI. For the models it
serves with 1bit, it runs the engine as a backend, the same way it runs `llama-server`. For a GGUF
Expand All @@ -31,6 +32,20 @@ a request has had no progress for `--watchdog` seconds, kills its backend and ex
([serve.md, "When a backend hangs"](serve.md#when-a-backend-hangs)). Lemonade's BackendWatchdog
then loads the model again.

## Getting Lemonade with the engine

Two ways, and the rest of this page is what sits under them.

- **The appliance.** [1bit OS](os-v3.md) is Lemonade Server with the engine inside, on a USB stick that
boots a Ryzen AI MAX+ 395 with Secure Boot on, and `1bit-install` puts the same system on a disk
([releases.md](releases.md)).
- **An Ubuntu that already runs Lemonade.** The `lemonade-onebit` package adds the engine as a Lemonade
backend and nothing else changes; on Ubuntu 26.04 the engine plugs into the stock `lemond` from
Lemonade's own PPA ([below](#ubuntu-2604-the-ppas-lemond)).

Either way, the models Lemonade routes to 1bit are served on the Radeon 8060S iGPU or on the XDNA 2 NPU
([models.md](models.md), [npu.md](npu.md), [the Strix Halo guide](https://1bit.gg/strix-halo.html)).

## How it got here

Step 1 first went the other way. `1bit lemonade` ran Lemonade v11.9.0's server
Expand Down
Loading