How to Install and Run Lemonade on Your Computer

Lemonade (lemonade-server.ai) installs as a local AI runtime that gives your machine a GUI, CLI, and API endpoints for text, image, speech, transcription, and embedding workloads. The site lists install paths for Windows, macOS, Ubuntu, Arch, Fedora, Debian, Docker, and Snap, and describes setup as "up and running in minutes." If your platform is on that list, you can install directly; if not, Docker or Snap is the fallback.

What you get after installing

Per the site, installation equips your computer with:

• An AI runtime — the engine that runs models locally
• A GUI — a graphical interface for chatting and managing models
• A CLI — command-line access for scripting and automation
• API endpoints — so your own apps can call the runtime

Lemonade is also described as "omni modal," meaning one install covers chat, vision, image generation, speech, transcription, and embeddings rather than separate tools per task.

Step 1: Pick your platform

Choose the native package for your OS if one exists — it's the shortest path. Use Docker or Snap when you want isolation, a reproducible environment, or your OS isn't directly listed.

Step 2: Install

Run the installer or package command for your platform. The site's Quick Start section is the authoritative reference for the exact command per OS, since package names and repositories change between releases.

Expected result: the runtime, GUI, CLI, and API endpoints are all present on your machine after one install step. You don't install these separately.

Step 3: Verify it's running

After install, confirm three things:

1. The GUI opens — launch it and check that it loads without errors.
2. The CLI responds — run a basic command to confirm the runtime is reachable.
3. The API answers — the site notes Lemonade works with hundreds of apps "thanks to the OpenAI API standard," so you can point any OpenAI-compatible client at your local endpoint to test it.

If all three work, your local AI stack is live.

Step 4: Connect an app or start building

You have three routes from here, all described on the site:

• Chat with Lemonade — use the built-in GUI directly
• Connect to agents — wire the runtime into agent frameworks
• Embed the SDK — add native support or an embedded copy of Lemonade inside your own application

For the third route, the site points to an Embeddable SDK, an API Reference, and the source on GitHub. Start with the API Reference if you're integrating an existing app; use the SDK if you're shipping Lemonade inside your own product.

Common sticking points

• Platform not listed natively. Fall back to Docker or Snap rather than trying to force a package built for another distro.
• Assuming cloud dependency. The site states Lemonade is local-first and routes to servers and cloud APIs only on demand — so a working install should function without a cloud account, though the site doesn't detail offline model management.
• Skipping the API test. Since OpenAI API compatibility is the main integration path, verifying the endpoint early saves debugging later.
• Version drift. The site says a new release ships every week. If a command from a tutorial fails, check the current release notes before assuming your setup is broken.

What "free" and "private" mean here

The site describes Lemonade as "free to use," "private by design," and "transparent, zero telemetry," with "no upsell," and says data stays where you put it. Those are the site's own claims about the product's design. The page evidence does not list pricing tiers, paid plans, or account requirements, so treat any specific cost or login expectation as unconfirmed until you check the current site.

Where to go next

• Quick Start — per-platform install commands
• API Reference — endpoint details for integration
• Embeddable SDK — for shipping Lemonade inside your app
• Source on GitHub — for build details and contribution
• Marketplace — apps already integrated with Lemonade

The project is community-steered through open working groups, so if your platform or use case isn't covered, the contribution guide and Discord are the places to ask.