# Installation

Morphy ships as the **CLI** (terminal app) and the **Desktop app** (graphical). Pick whichever
you prefer — both use the same engine and the same settings.

After installing, verify with:

```bash
morphy --version
```

---

## CLI

### macOS / Linux — one‑line installer

```bash
curl -fsSL https://morphy.fyi/install.sh | bash
```

Installs the `morphy` binary to `~/.local/bin`. If that directory is not on your `PATH`, the
installer prints the line to add to your shell profile.

### npm

```bash
npm install -g @morphy-agent/cli
```

### pip

```bash
pip install morphy-agent
```

### Homebrew (macOS / Linux)

```bash
brew install deadraid/morphy/morphy
```

### Windows

```powershell
npm install -g @morphy-agent/cli
```

Or download `morphy-windows-x86_64.exe` (or `-aarch64`) from the
[latest release](https://github.com/deadraid/morphy-releases/releases/latest).

### Manual download

Grab the binary for your platform from the
[latest release](https://github.com/deadraid/morphy-releases/releases/latest), make it
executable, and put it on your `PATH`. Every release also ships `sha256sums.txt` so you can
verify your download:

```bash
sha256sum -c sha256sums.txt
```

---

## Desktop app

### macOS / Linux — one‑line installer (recommended)

```bash
curl -fsSL https://morphy.fyi/install-desktop.sh | bash
```

This installs **Morphy.app** to `/Applications` (macOS) or an AppImage to `~/.local/bin`
(Linux), and on macOS removes the quarantine flag so the app opens without warnings.

### macOS — Homebrew cask

The desktop app is a **separate** Homebrew package from the CLI — it's a cask, with its own
name `morphy-desktop`:

```bash
brew install --cask deadraid/morphy/morphy-desktop
```

> CLI vs Desktop in Homebrew:
> - CLI (terminal binary): `brew install deadraid/morphy/morphy`
> - Desktop (graphical app): `brew install --cask deadraid/morphy/morphy-desktop`
>
> The app is not signed with a paid Apple Developer ID, so macOS will ask you to approve it
> on first launch. Clear the quarantine flag with `xattr -dr com.apple.quarantine
> "/Applications/Morphy.app"` or click "Open Anyway" — see
> [Troubleshooting](troubleshooting.md#macos-says-the-app-cannot-be-opened).

### Windows / direct downloads

Download the installer for your platform from the
[latest release](https://github.com/deadraid/morphy-releases/releases/latest):

| Platform | File |
| --- | --- |
| macOS (Apple Silicon) | `Morphy-<version>-arm64.dmg` |
| macOS (Intel) | `Morphy-<version>-x64.dmg` |
| Windows | `Morphy-<version>-x64.exe` |
| Linux | `Morphy-<version>-x64.AppImage` or `.deb` |

---

## Updating

- **CLI:** re‑run the installer, or `npm update -g @morphy-agent/cli` / `pip install -U morphy-agent` /
  `brew upgrade morphy`.
- **Desktop:** re‑run the desktop installer or `brew upgrade --cask morphy`, or download the
  latest installer.

## Uninstalling

- **CLI:** delete the `morphy` binary (e.g. `~/.local/bin/morphy`), or use your package
  manager (`npm uninstall -g @morphy-agent/cli`, `pip uninstall morphy-agent`, `brew uninstall morphy`).
- **Desktop:** delete `Morphy.app` / the AppImage, or `brew uninstall --cask morphy`.
- Your settings and sessions live in `~/.morphy` — delete that folder to remove them too.