# 使用 Homebrew 安装 soar

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

## 安装

```sh
sudo av install brew:soar
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install soar
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:soar
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/soar>
- **版本:** 0.12.7
- **来源摘要:** Fast, modern package manager for Static Binaries, Portable Formats and more
- **主页:** <https://soar.qaidvoid.dev>
- **仓库:** <https://github.com/pkgforge/soar>
- **上游文档:** <https://soar.qaidvoid.dev/>
- **许可证:** MIT
- **源码归档:** <https://github.com/pkgforge/soar/archive/refs/tags/v0.12.7.tar.gz>
- **最后更新:** 2026-07-16T18:38:37Z
- **已生成:** 2026-07-25T07:20:51+00:00

## 可执行文件

- soar (cli)
- soar (别名)

## 构建依赖

- rust

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-25
- 管理器版本: 0.12.7
- 管理器更新时间: 2026-07-16
- 本地数据: OK
- 上游仓库: https://github.com/pkgforge/soar
- 检测到的最新版本: v0.12.7 (当前)
## 项目历史与用法

Soar is a Rust package manager from pkgforge for installing static binaries, AppImages, FlatImages, and other portable packages on Linux without requiring root access.

### 项目历史

The first public GitHub release, v0.1.0, appeared on 2024-10-10 with core package-manager commands for search, install, update, remove, query, run, use, symlink ownership checks, configuration loading, and installed-package tracking.

By v0.3.0 on 2024-10-26, Soar added AppImage integration, portable home and config directory support, health checks, terminal image display support, and package metadata improvements.

The official release notes describe the v0.10 line as adding GitHub and GitLab release sources, build-from-source support, lifecycle hooks, Landlock sandboxing, and system-wide installs. The v0.12 line consolidated repositories around the unified soarpkgs repository and added repository-management CLI features, fuzzy search, metadata signature verification, local-file installs, and shell completions.

### 采用历史

Soar is distributed as a single statically linked executable with an install script, and the official docs position it for use across Linux distributions including Debian, Arch, Fedora, and Alpine.

Homebrew includes the package as brew:soar, while upstream documentation points users to the official soarpkgs repository as the default package source.

### 使用方式

Typical usage starts by running the official install script, adding the Soar bin path to PATH, and installing packages with commands such as `soar install neovim`.

Soar supports imperative package operations, repository configuration in `~/.config/soar/config.toml`, declarative package management through `~/.config/soar/packages.toml`, direct GitHub and GitLab release sources, custom URL packages, hooks, sandboxing, profiles, and optional system mode.

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

Soar matters to package-manager users because it explores a distro-independent model centered on portable binaries rather than distro-native build recipes, while still keeping package metadata, repository signatures, local install state, declarative manifests, and update behavior under one CLI.

Its relationship with soarpkgs gives it a Homebrew-like split between package manager and package repository, but targeted at static binaries, AppImages, FlatImages, RunImages, and similar portable Linux formats.

### 时间线

- 2024-10-10: Soar v0.1.0 released with core package-manager commands.
- 2024-10-11: v0.2.0 added arbitrary file downloads and remote binary runs.
- 2024-10-26: v0.3.0 added AppImage integration and portable home/config support.
- 2025-01-24: v0.10.3 continued the v0.10 line that official notes associate with GitHub/GitLab sources, builds, hooks, sandboxing, and system-wide installs.
- 2026-02-24: v0.12.0 consolidated repositories around the unified soarpkgs repository.
- 2026-06-27: GitHub listed Soar v0.12.6 as the latest release.

### Related projects

- soarpkgs is the official package repository that provides package metadata consumed by Soar.
- pkgforge hosts the Soar project and related package infrastructure.

### 来源

- Official CLI reference: https://soar.qaidvoid.dev/cli-reference
- Official GitHub releases: https://github.com/pkgforge/soar/releases
- Official configuration docs: https://soar.qaidvoid.dev/configuration
- Official declarative package docs: https://soar.qaidvoid.dev/declarative
- Official docs: https://soar.qaidvoid.dev/
- Official release notes: https://soar.qaidvoid.dev/releases


## 安全说明

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



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.config/soar/config.toml, ~/.config/soar/packages.toml, /etc/soar/config.toml
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** soar
- **Version Scheme:** 0
- **Revision:** 0
- **Requirements:** linux
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Package publisher tools](https://www.automicvault.com/zh-hans/pkg/package-publishers/) - Belongs to a package publishing or registry command family.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [bower](https://www.automicvault.com/zh-hans/pkg/brew/bower/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, package-managers.
- [opam](https://www.automicvault.com/zh-hans/pkg/brew/opam/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, package-managers.
- [orogene](https://www.automicvault.com/zh-hans/pkg/brew/orogene/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, rust.
- [rv](https://www.automicvault.com/zh-hans/pkg/brew/rv/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, rust.
- [uv](https://www.automicvault.com/zh-hans/pkg/brew/uv/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, rust.
- [wally](https://www.automicvault.com/zh-hans/pkg/brew/wally/) - Shares av.db curated category or tags: cli, developer-tools, package-manager, rust.
- [action-validator](https://www.automicvault.com/zh-hans/pkg/brew/action-validator/) - Shares av.db curated category or tags: cli, developer-tools, rust.
- [add-determinism](https://www.automicvault.com/zh-hans/pkg/brew/add-determinism/) - Shares av.db curated category or tags: cli, developer-tools, rust.

## Combined YAML source

View the package source record on GitHub. [combined/soar.yml](https://github.com/automic-vault/db/blob/main/combined/soar.yml)


## 来源

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
