# 使用 Homebrew, winget 安装 astro

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

## 安装

```sh
sudo av install brew:astro
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install astro
```

  证据: local Homebrew formula metadata

### Windows

- winget (92%):

```sh
winget install --id Astronomer.Astro -e
```

  证据: Windows Package Manager source index: Astronomer.Astro from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:astro
- **软件包管理器:** Homebrew
- **版本:** 1.43.1
- **来源摘要:** To build and run Airflow DAGs locally and interact with the Astronomer API
- **主页:** <https://www.astronomer.io/>
- **仓库:** <https://github.com/astronomer/astro-cli>
- **最后更新:** 2026-07-26T13:19:53+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- astro (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Astro CLI is Astronomer's command-line interface for developing Apache Airflow projects locally and deploying them to Astronomer products. In package-manager terms it is the small Go binary that turns a directory of DAGs, requirements, Dockerfile, and Astro project metadata into a repeatable local Airflow environment and a deployable unit.

### 项目历史

The CLI grew out of Astronomer's Airflow platform tooling and was distributed publicly as the astro-cli repository. Its README describes it as a command-line interface for data orchestration that works with Astronomer products, and its release notes mark all releases before 1.0.0 as beta. Version 1.0.0 was published in May 2022 as the converged Astro CLI release, while Astronomer's own CLI release notes document the transition from older astrocloud command names to the standardized astro login, astro logout, astro dev init, and deployment commands.

The tool's center of gravity is local developer experience for Airflow: astro dev init creates a project skeleton, astro dev start runs the Airflow stack locally in containers, and deployment/workspace commands talk to Astronomer APIs. Later releases added Windows package-manager support, organization and context switching, richer config commands, and deployment inspection/logging features.

### 采用历史

Homebrew packages the CLI as astro and the upstream README documents brew install astro for macOS, winget install -e --id Astronomer.Astro for Windows, and an install.astronomer.io shell installer for Linux. That multi-channel distribution matters because Airflow teams often need the same CLI in laptops, CI, and enterprise Windows workstations.

Adoption is tied to Astronomer's hosted Astro and Astronomer Software/Private Cloud products rather than being a general Airflow replacement. The CLI became the user-facing packaging point for Astronomer's Airflow workflow: initialize a project, run it locally, test DAGs, and deploy to a managed Deployment.

### 使用方式

Typical package usage starts with brew install astro, then astro dev init in an empty project directory and astro dev start to build and run local Airflow containers. The generated project includes dags, tests, Dockerfile, requirements.txt, packages.txt, plugins, include, and an .astro/config.yaml file for project settings.

Astro CLI stores project settings in .astro/config.yaml and global settings in a user-level Astro config file. Astronomer documentation notes project-level settings such as webserver and Postgres ports and says global configuration is stored centrally with the executable, for example under ~/.astro/config.yaml on Unix-like systems. Login-related context and cached identity state also live in the user-level config.

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

For package nerds, astro is a good example of a cloud-product CLI that still earns a normal package-manager slot because its heavy dependencies are external services and container runtimes, not vendored platform SDKs. The package is mostly a single command surface, but it orchestrates Docker/Podman, generated project files, Airflow commands, and authenticated API calls.

The formula is also notable because it has to track a fast-moving SaaS CLI while preserving enough compatibility for CI images and developer laptops. Astronomer's docs warn that backward compatibility is guaranteed only between matching minor versions of the platform and CLI, which makes package version selection operationally important.

### 时间线

- 2021: Public beta-era Astro CLI releases were already being published from the astronomer/astro-cli repository.
- 2022-05-27: Astro CLI v1.0.0 was published as the converged v1 release.
- 2022-06-28: Astronomer documented Astro CLI 1.2.0 and the standardized astro command names.
- 2022-10-27: Astro CLI v1.6.0 added documented winget installation support for Windows.
- 2026: Astronomer documentation continues to position Astro CLI as the command reference and local development tool for Astro projects.

### Related projects

- Apache Airflow is the workflow engine Astro CLI packages around for local and managed development.
- Docker or Podman provide the local container runtime used by astro dev commands.
- Astronomer Astro and Astronomer Software/Private Cloud are the platform targets for deployment and context commands.

### 来源

- <https://github.com/astronomer/astro-cli#readme>
- <https://github.com/astronomer/astro-cli/releases/tag/v1.0.0>
- <https://github.com/astronomer/astro-cli/releases/tag/v1.6.0>
- <https://www.astronomer.io/docs/astro/cli/configure-cli>
- <https://www.astronomer.io/docs/astro/cli/develop-project>
- <https://www.astronomer.io/docs/astro/cli/release-notes>


## 安全说明

没有找到 astro 的匹配本地密钥处理 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

- Unix: .astro/config.yaml, ~/.astro/config.yaml
- Windows: .astro/config.yaml, %USERPROFILE%\.astro\config.yaml

## Credential files

- Unix: ~/.astro/config.yaml
- Windows: %USERPROFILE%\.astro\config.yaml
## 其他软件包管理器记录

- winget - Astronomer.Astro: normalized package name match | Windows Package Manager source index: Astronomer.Astro from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

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


## 来源

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