# Swama

A local AI runtime for Apple Silicon Macs that runs MLX models and provides an API, command-line tool, and menu bar app.

> This is the Markdown version of the Swama page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/swama>

- **Latest version**: `2.5.1`
- **Developer**: Trans-N K.K.
- **Homepage**: <https://github.com/Trans-N-ai/swama>
- **Categories**: [AI Tools](https://opennavo.com/categories/ai)
- **Install**: `brew install --cask swama`
- **30-day installs**: 6
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/Trans-N-ai/swama/releases/download/v2.5.1/Swama.dmg>
- **SHA-256**: `eaa84fe25979df8523d2334e6c491240d0bb55723cc950fa2b151eebcdbc328f`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "Swama.app"
      ],
      "target": "/Applications/Swama.app"
    },
    "phase": "install",
    "sources": [
      "Swama.app"
    ],
    "target": "/Applications/Swama.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/Library/Preferences/trans-n.ai.Swama.plist"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Swama is a local AI runtime for Apple Silicon Macs, implemented in Swift using Apple's MLX. It runs supported models on the Mac and makes them available through an OpenAI-compatible API, a command-line tool, and a menu bar app.

- Run language, vision, embedding, and speech-recognition models locally; text-to-speech is experimental.
- Serve chat completions, embeddings, audio transcription, and other supported requests through the API. Chat completions support streaming, tool calling, and image input with vision models.
- Use the `/v1/decisions` endpoint to score predicates, choices, and ratings without generating text.
- Start a model with a short alias; Swama downloads it from Hugging Face on first use. The API server listens on port `28100` by default.

Install with `brew install --cask swama`. The package installs `Swama.app`. The documented requirements are an Apple Silicon Mac and macOS 15.4 or later. To use the command-line tool after installing the app, select **Install Command Line Tool…** from the menu bar app to add `swama` to your PATH. To get started, run `swama run qwen3.5 "Hello!"`; for a local-only API server, run `swama serve --host 127.0.0.1`.

The Responses API is a stateless subset, and text-to-speech is experimental. Models are downloaded when first used.

Sources: [Swama project](https://github.com/Trans-N-ai/swama) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/s/swama.rb)

## System requirements

- macOS 15 or later · Version: 2.5.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swama.rb> · Checked 2026-11-22
  - <https://github.com/Trans-N-ai/swama/releases/download/v2.5.1/Swama.dmg>
  - SHA-256: `eaa84fe25979df8523d2334e6c491240d0bb55723cc950fa2b151eebcdbc328f`

## Swama security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/Trans-N-ai/swama> · Open source: Yes — <https://github.com/Trans-N-ai/swama> · Checked 2026-11-14

## Uninstall

- `brew uninstall --cask swama`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask swama`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Preferences/trans-n.ai.Swama.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swama.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.5.1 (2026-10-07)

Fixes the embedded CLI’s first-inference failure on Macs other than the build machine. Also includes changes from v2.5.0, whose assets were withdrawn shortly after publication.

**Fix**

- Ships SwamaCore.bundle beside the embedded CLI.
- Fixes first-inference CLI exits on other Macs.

**APIs**

- Adds POST /v1/decisions and POST /v1/systemone.
- Decision requests accept up to four inline data-URL images.
- Old SGLang-format requests get a message pointing to OpenAI format.

**Other**

- Cancels generations when a client disconnects.
- Requires Apple Silicon and macOS 15.6 or later.

## Facts and sources

- <https://opennavo.com/apps/swama>
- <https://opennavo.com/apps/swama/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swama.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/swama>
- <https://github.com/Trans-N-ai/swama> · Checked 2026-11-14
