Adelie Homebrew Tap
adelie-ai/homebrew-adelie
Construir Adelie e MCP servers do source via Homebrew com deps granulares
Ver no GitHubTap Homebrew que constrói o assistente desktop Adelie, seus clientes e servidores MCP a partir do código-fonte. Cada componente é uma fórmula independente com suas próprias dependências, permitindo instalação modular sem bloat desnecessário.
Instalação
npx convez-ai adelie-ai/homebrew-adelie1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Instalar o assistente desktop Adelie em Linux/macOS de forma modular
- Adicionar servidores MCP (weather, CVE, geocode, tasks, etc) ao Claude
- Compilar componentes individuais do Adelie com controle de dependências
Veredito

Solução técnica bem estruturada para quem quer rodar Adelie em macOS/Linux sem overhead de dependências não usadas. Requer familiaridade com Homebrew e build from source; melhor para usuários avançados que valorizam controle granular.
README
A tradução para o português deste README ainda está na fila.
Adelie Homebrew tap
A Homebrew tap that builds the Adelie desktop assistant, its clients, and its MCP servers from source. Each component is its own formula with its own dependency set, so you only pull in what a given piece needs — no GTK unless you install the GTK client, no espeak-ng unless you install voice, and so on.
Tapping
This repo is the tap. Add it (the name must be adelie-ai/adelie so the
meta-formulas resolve their cross-references):
# from a local checkout (substitute your path)
brew tap adelie-ai/adelie /path/to/homebrew-adelie
# …or, once it's pushed to github.com/adelie-ai/homebrew-adelie
brew tap adelie-ai/adelie
Then install components by their plain name (Homebrew resolves them within the tap):
brew install adelie-daemon # the assistant orchestrator (Linux)
brew install adele-tui # terminal client (Linux + macOS)
brew install weather-forecast-mcp # one MCP server
Components
| Formula | Binary(ies) | Platform | Extra deps (beyond rust + cmake) |
|---|---|---|---|
adelie-daemon | desktop-assistant-daemon, adelie-dbus-bridge | Linux | postgresql@17, pgvector, pkg-config |
adele-tui | adele | Linux + macOS | — |
adele-gtk | adele-gtk | Linux | gtk4, webkitgtk, pkg-config |
adele-voice | adele-voice | Linux | espeak-ng, alsa-lib, pkg-config |
command-mcp | command-mcp | Linux + macOS | — |
cve-mcp | cve-mcp | Linux + macOS | — |
fileio-mcp | fileio-mcp | Linux + macOS | — |
geocode-mcp | geocode-mcp | Linux + macOS | — |
internet-radio-mcp | internet-radio-mcp | Linux + macOS | mpv |
tasks-mcp | tasks-mcp | Linux + macOS¹ | — |
terminal-mcp | terminal-mcp | Linux + macOS | — |
timeclock-mcp | timeclock-mcp | Linux + macOS | — |
weather-forecast-mcp | weather-forecast-mcp | Linux + macOS | — |
adelie | (meta) | Linux | installs adelie-daemon + adele-tui |
adelie-mcp | (meta) | Linux + macOS | installs all 9 MCP servers |
¹ tasks-mcp builds on macOS but its dbus activation mode needs a D-Bus session
bus (Linux); the stdio serve mode works anywhere.
rust and cmake are :build deps on every Rust formula (cmake covers the
aws-lc-rs rustls crypto provider, and whisper.cpp for voice).
Wiring an MCP server into Claude / the assistant
Every MCP server runs over stdio with the serve subcommand:
claude mcp add weather -- weather-forecast-mcp serve
Source pinning
Each formula has two sources:
- a stable
urlpinned to a specificmaincommit —brew install <name>builds that exact revision, reproducibly; - a
headspec —brew install --HEAD <name>builds the currentmain.
To move a formula to a newer commit, update the revision: (and, for
adele-gtk, the DESKTOP_ASSISTANT_REV constant + the adelie-daemon /
meta revisions to match).
Build needs network. These formulas build from source and let
cargofetch crates during the build (normalcargo buildbehaviour), rather than vendoring every dependency as a Homebrewresource. That's fine for localbrew install, but means they aren't set up for Homebrew CI bottling. To bottle them you'd vendor the crate graph.
Caveats & platform notes
- Platforms: the daemon, GTK client, and voice service are Linux-only — they rely on the Secret Service keyring, D-Bus, systemd, GTK/WebKitGTK, and ALSA. The terminal client and the MCP servers build cleanly on both Linux and macOS.
adelie-daemonneeds PostgreSQL + pgvector at runtime (conversation store + embedding/FTS hybrid search). The formula installspostgresql@17+pgvectorand the post-install caveats walk throughcreatedb+CREATE EXTENSION vector.adele-gtkrewrites its../desktop-assistantpath-deps to pinned git deps at build time (Homebrew builds each repo in isolation). Ifbrew install webkitgtkisn't available on your distro, install the system WebKitGTK 6.0 dev package instead.adele-voicedownloads STT/TTS model weights on first run (not bundled). After install:adele-voice check-setup. The wake word (.rpw) is recorded locally.- systemd:
adelie-daemonandadele-voiceinstall their upstream user units under<keg>/share/<name>/systemdfor reference; the caveats show how to copy them into~/.config/systemd/userwithExecStartpointed at the keg.
Not in the tap
adele-kde(Plasma KCM + plasmoids) — a KDE Plasma desktop component suite that must integrate with the system Qt6/KF6/Plasma, which Homebrew can't provide cleanly. Install it from its own repo with the project'sjustrecipes (just kcm-install,just widget-install).pim-mcp(binarycalendar-mcp),skills-mcp,web-mcp— no public git remote yet, so there's nothing for Homebrew to fetch. Push them togithub.com/adelie-ai/<repo>and add a formula (copyweather-forecast-mcp.rband swap the url/revision/binary;pim-mcpbuilds fromservers/calendar-mcp).
Licensing
This tap — the formula definitions in this repo — is BSD-2-Clause (see LICENSE),
matching the Homebrew convention for taps. That covers only the packaging
metadata; the Adelie software the formulas build is AGPL-3.0-or-later. MCP-server
formulas omit a license stanza pending confirmation of each repo's license.