# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opscanvas.io/oscar/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.