> For the complete documentation index, see [llms.txt](https://docs.opscanvas.io/oscar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opscanvas.io/oscar/install.md).

# Install Oscar

Oscar ships as prebuilt binaries for macOS and Linux. Windows users can run Oscar through WSL2.

```bash
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-install.sh | bash
```

## After Install

Set up model access, then launch Oscar in the terminal:

```bash
export ANTHROPIC_API_KEY="sk-ant-..."
oscar
```

If you use AWS Bedrock instead:

```bash
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
oscar
```

## Direct Downloads

These are standalone binaries. Download the one for your platform, make it executable, and move it onto your `PATH`.

| Platform            | Download                                                                                                         |
| ------------------- | ---------------------------------------------------------------------------------------------------------------- |
| macOS Apple Silicon | [oscar-macos-arm64](https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-arm64) |
| macOS Intel         | [oscar-macos-x64](https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-x64)     |
| Linux x64           | [oscar-linux-x64](https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-x64)     |
| Linux ARM64         | [oscar-linux-arm64](https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-arm64) |

### macOS

Download the binary, make it executable, and place it on your `PATH`:

```bash
# Apple Silicon
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-arm64 -o oscar

# Intel
# curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-x64 -o oscar

chmod +x oscar
mkdir -p "${HOME}/.local/bin"
mv oscar "${HOME}/.local/bin/oscar"
```

If `~/.local/bin` is not already on your `PATH`, add it to your shell config (e.g. `~/.zshrc`):

```bash
export PATH="$HOME/.local/bin:$PATH"
```

If macOS blocks the binary because it was downloaded from the internet:

```bash
xattr -d com.apple.quarantine "${HOME}/.local/bin/oscar"
```

### Linux

```bash
# x64
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-x64 -o oscar

# ARM64
# curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-arm64 -o oscar

chmod +x oscar
mkdir -p "${HOME}/.local/bin"
mv oscar "${HOME}/.local/bin/oscar"
```

If `~/.local/bin` is not already on your `PATH`, add it to your shell config (e.g. `~/.bashrc`):

```bash
export PATH="$HOME/.local/bin:$PATH"
```

### Windows (WSL2)

Oscar runs on Windows through [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install). Install WSL2 with a Linux distribution (Ubuntu recommended), then run the installer inside your WSL2 terminal:

```bash
# From a WSL2 terminal (e.g. Ubuntu)
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-install.sh | bash
```

This installs the Linux x64 binary, which runs natively inside WSL2.

## Verify Downloads

Oscar publishes a checksum manifest with every release:

```bash
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/checksums.txt
```

Use it to verify any binary or installer you download manually.