A local-first multi-agent app development platform, built on PenguinHarness
title: Quickstart description: Pick one of four routes, the desktop app, the CLI and Web App, Docker, or the SDK, to install Adelie and run your first Task.
Adelie has four ways in: the desktop app, the CLI and Web App, Docker, and the SDK. They run the same engine and differ only in how you meet it. Pick the route that fits you; each route's page takes you all the way to a first Task.
Before you begin
Adelie ships with no built-in model credentials, so you configure a model before your first Task. An API key for one provider is enough, and each route's page covers this step.
A model is always referenced as a (provider, model_id) pair; the provider is never inferred from the model id. See Models & Providers for the built-in groups.
Choose a route
| Route | Best for | Terminal needed? |
|---|---|---|
| Desktop app | Using Adelie as a product, straight away | No, and it installs the penguin command for you |
| CLI and Web App | Servers and remote machines, or wanting the penguin command |
Once, to install |
| Docker | A server you deploy rather than install, with one container and one volume | Once, to start it |
| SDK | Embedding the engine in your own TypeScript program | Yes |
If you are unsure, take the desktop app. It has the fewest steps, and moving to another route later costs you nothing. The macOS and Windows installers are signed, so only a downloaded Linux AppImage needs a step before its first launch, which the desktop app page covers.
What all routes share
- One data root:
~/.adelie/data(%USERPROFILE%\.adelie\dataon Windows;/datainside the container). Agents, model configuration and past Sessions live there, so routes on the same machine can be mixed freely: a model configured in the desktop app is immediately usable from the CLI and the SDK. - One server at a time: a data root only ever runs one server process. If you already started one with
penguin web, the desktop app attaches to it instead of starting a second one. - One interface: the desktop app and
penguin webopen the same Web App. The desktop app embeds the server and skips the login.
Next steps
- Desktop app: a double-click install that opens already signed in.
- CLI and Web App: one line installs
penguin, with the full installation reference. - Docker: the official image, for a server you reach over the network.
- SDK: create agents and Sessions from your own program.
- Key concepts: the terms used throughout these docs.