---
title: "Installation"
description: "Install Caro on macOS, Linux, or Windows"
url: "https://caro.sh/docs/installation"
markdown_url: "https://caro.sh/docs/installation.md"
lang: "en"
type: "website"
image: "https://caro.sh/og/docs/installation.png"
---

# Installation

Caro is distributed as a single binary with no external dependencies. Choose your preferred installation method below.

## Quick Install (Recommended)

Install Caro with our install script:

```
curl -fsSL https://caro.sh/install.sh | sh
```

Or if you prefer wget:

```
wget -qO- https://caro.sh/install.sh | sh
```

## Package Managers

### Homebrew (macOS/Linux)

```
brew install wildcard/tap/caro
```

### Cargo (All Platforms)

```
cargo install cmdai
```

## Manual Installation

Download the latest release for your platform from [GitHub Releases](https://github.com/wildcard/caro/releases):

- **macOS (Apple Silicon)**: `caro-darwin-arm64`
- **macOS (Intel)**: `caro-darwin-x86_64`
- **Linux (x86\_64)**: `caro-linux-x86_64`
- **Linux (ARM64)**: `caro-linux-arm64`
- **Windows**: `caro-windows-x86_64.exe`

### macOS/Linux

```
# Download the binary
curl -LO https://github.com/wildcard/caro/releases/latest/download/caro-darwin-arm64

# Make it executable
chmod +x caro-darwin-arm64

# Move to your PATH
sudo mv caro-darwin-arm64 /usr/local/bin/caro
```

## Verify Installation

```
$ caro --version
caro 0.1.0
```

## First-Time Setup

When you first run Caro, it will guide you through an interactive setup wizard to configure your preferences:

```
$ caro init
```

This will configure your preferred shell, safety level, and other options. You can re-run `caro init` at any time to change your settings.

## Next Steps

- [Quick Start Guide](https://caro.sh/docs/quickstart) - Your first commands
- [Configuration](https://caro.sh/docs/configuration) - Customize your setup
- [Security](https://caro.sh/docs/security) - Important safety information