Skip to content

Swama

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

CaskAI Tools 593
Install command
brew install --cask swama
30-day installs
6
#2262 in App
1-year installs
433
Last 365 days
Latest version
2.5.1
Download size
38MB
dmg
Release cadence
Monthly
0 releases in 30 days

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 · Homebrew cask

At a glance

System
macOS 15 or later
Chip
Apple silicon
Auto-updates
No
Repository
Open source · MIT · Updated 2 days ago★593
Developer
Trans-N K.K.
Homebrew
Available; updated by Homebrew
Also known as
swama
Homepage
github.com/Trans-N-ai/swama
Token
swama

Checked

What’s new in 2.5.1

New · OpenNavo editorial

  • FixShips SwamaCore.bundle beside the embedded CLI.
  • APIsAdds POST /v1/decisions and POST /v1/systemone.
  • OtherCancels generations when a client disconnects.

How to install Swama on Mac

Homebrew installs the app in your Applications folder.

Install without Homebrew

Download the same file Homebrew uses: Install Details

Uninstall Swama and optional data cleanup

Uninstall command
brew uninstall --cask swama

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

Deep clean (optional)
Uninstall command
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.

Questions about Swama

Is Swama safe?

Swama is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 6 times through Homebrew in the last 30 days.

Is Swama open source?

Swama’s source code is public on GitHub (Trans-N-ai/swama) under the MIT license.

How do I completely uninstall Swama on a Mac?

Run brew uninstall --cask swama. To delete its settings and caches as well, run 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. That also deletes ~/Library/Preferences/trans-n.ai.Swama.plist.

Does Swama run on Apple silicon (M1 and later) Macs?

Yes, and only there: it does not install on Intel Macs. It needs macOS 15 or later.

Where does Swama store its settings and data?

Its settings are in ~/Library/Preferences/trans-n.ai.Swama.plist. These locations come from Homebrew’s clean-up list.

What is the latest version of Swama?

The latest version is 2.5.1, added to Homebrew on Oct 7, 2026. Run brew upgrade --cask swama to update it.

Similar Apps

  • NVIDIA Personal AI RouterRoutes independent local inference requests across compatible computers on the same network.
  • LumoProton's desktop AI assistant with encrypted conversations.
  • LangdockA native macOS desktop app for Langdock’s AI workspace, including Chat, Agents, Workflows, workspace settings, and integrations.
  • TauriTavernA native macOS client designed to provide a SillyTavern-compatible experience.
Browse all apps