# 使用 Homebrew, Nix 安装 localai

查看 localai 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:localai
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install localai
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#local-ai
```

  证据: nixpkgs package indexes: pkgs/by-name/lo/local-ai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:localai
- **软件包管理器:** Homebrew
- **版本:** 4.7.1
- **来源摘要:** OpenAI alternative
- **主页:** <https://localai.io>
- **仓库:** <https://github.com/mudler/LocalAI>
- **最后更新:** 2026-07-14T18:47:04Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- local-ai (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.7.1
## 项目历史与用法

LocalAI is an open-source local AI inference server and CLI that exposes OpenAI-compatible APIs for self-hosted models. It began in the 2023 local-LLM wave and grew from a local OpenAI API replacement into a broader multimodal AI engine with model galleries, backend management, web UI, agents, and distributed operation.

### 项目历史

The mudler/LocalAI repository was created in March 2023. The README describes LocalAI as an open-source AI engine for LLMs, vision, voice, image, and video on local hardware, with no GPU required and privacy-first operation because data stays on the user's infrastructure.

In 2023, LocalAI focused on making local models usable behind OpenAI-compatible endpoints. Official news from mid-2023 records rapid support for model galleries, GPU offload, Apple Metal, Falcon-family models, Hugging Face backends, stable-diffusion, text-to-audio, and static Linux binaries. A late-2023 maintainer update described a move toward a gRPC backend structure and a C++ llama.cpp backend to track upstream more closely.

By 2025 and 2026, LocalAI had expanded into a modular backend architecture. The v3.0.0 announcement introduced a backend gallery based on OCI images, realtime WebSocket APIs, dynamic VRAM handling, multimodal upgrades, and deprecation of older extras images. The v4.0.0 announcement framed the project as a complete AI orchestration platform with agents, Agenthub, a React UI rewrite, Canvas mode, MCP support, WebRTC realtime audio, and more backends.

### 采用历史

LocalAI rode the demand for self-hosted, OpenAI-compatible inference after local LLM tooling became mainstream in 2023. Its adoption signals are unusually strong for a CLI/server package: the official repository shows tens of thousands of stars, thousands of forks, and thousands of commits, while Homebrew and Nix packaging make the binary accessible outside container workflows.

The project broadened adoption by supporting multiple install styles: container images for CPU and GPU targets, binaries for Linux and macOS, model-gallery installs, and a local-ai CLI that can run models and open chat sessions. Its compatibility story also widened from OpenAI-style APIs to Anthropic Messages, Open Responses, Ollama-related workflows, and MCP-enabled agents.

### 使用方式

Users commonly run LocalAI as a local server, then point OpenAI-compatible SDKs or clients at localhost. The getting-started guide documents curl requests to /v1/chat/completions, model installation from the gallery, automatic backend detection based on GPU capabilities, built-in agents, and distributed mode for production or larger compute needs.

The Homebrew formula installs the local-ai executable, but official docs still treat containers as the fullest-feature path because some Python-based and heavy media backends are not included in all binaries. The binary reference documents direct Linux and macOS downloads and notes backend limitations for binary builds.

### 为什么软件包爱好者会关心

LocalAI is package-nerd significant because it turns a fast-moving stack of model runtimes, backends, APIs, and hardware-specific acceleration into one installable command. It is the sort of package where the formula is only the visible tip; the real work is coordinating llama.cpp, vLLM, whisper.cpp, stable-diffusion, MLX, OCI backends, GPU variants, and API compatibility.

It also captures a packaging shift in AI tooling: instead of a single static CLI, LocalAI became a launcher and orchestrator that downloads or connects model and backend artifacts at runtime. That makes it attractive to self-hosters and developers, but also means package metadata must clearly distinguish the CLI/server from the larger optional backend ecosystem.

### 时间线

- 2023: The mudler/LocalAI repository is created and early releases focus on local OpenAI-compatible inference.
- 2023: v1.x news records model galleries, GPU offload, Apple Metal support, text-to-audio, static binaries, and backend refactoring.
- 2025: v3.0.0 introduces the backend gallery, realtime WebSocket API, dynamic VRAM handling, and a new modular backend model.
- 2026: v4.0.0 adds native agents, Agenthub, React UI, Canvas mode, MCP support, WebRTC realtime audio, and additional backends.
- 2026: Official README highlights support for 60+ backends, multiple hardware accelerators, multimodal APIs, and distributed mode.

### Related projects

- llama.cpp, vLLM, whisper.cpp, stable-diffusion, MLX, and other model runtimes are backend building blocks named by the LocalAI README.
- OpenAI-compatible SDKs and clients are primary integration targets because LocalAI exposes compatible API endpoints.
- Ollama, GPT4All, and other local-model tools sit in the same self-hosted inference ecosystem, while LocalAI differentiates itself through broad API compatibility and backend orchestration.

### 来源

- <https://api.github.com/repos/mudler/LocalAI>
- <https://github.com/mudler/LocalAI>
- <https://github.com/mudler/LocalAI/discussions/1222>
- <https://github.com/mudler/LocalAI/discussions/5689>
- <https://github.com/mudler/LocalAI/discussions/9006>
- <https://localai.io/basics/getting_started/>
- <https://localai.io/basics/news/index.html>
- <https://localai.io/reference/binaries/>


## 安全说明

没有找到 localai 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


## 其他软件包管理器记录

- Nix - local-ai: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/lo/local-ai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/localai.yml](https://github.com/mxcl/pkgdb/blob/main/combined/localai.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
