# Where to Download OfficeCLI Binaries Manually: Complete Guide for All Platforms

> Manually download OfficeCLI binaries from GitHub Releases. Get pre-compiled executables for macOS, Linux, and Windows without extra dependencies. Your complete guide.

- Repository: [OfficeAI/OfficeCLI](https://github.com/iofficeai/OfficeCLI)
- Tags: how-to-guide
- Published: 2026-07-09

---

**OfficeCLI binaries are available for manual download from the GitHub Releases page**, where you'll find pre-compiled, self-contained executables for macOS (Apple Silicon and Intel), Linux (x64 and ARM64), and Windows (x64 and ARM64) that require no additional runtime dependencies.

The iOfficeAI/OfficeCLI repository distributes standalone binaries for users who prefer manual installation over package managers. According to the repository's documentation in [`README.md`](https://github.com/iOfficeAI/OfficeCLI/blob/main/README.md) (lines 29-38), the project maintains a comprehensive release matrix on GitHub Releases containing single-file executables that embed the .NET runtime, eliminating the need for separate framework installations.

## Official Download Location: GitHub Releases

The canonical source for OfficeCLI binaries is the **GitHub Releases** page associated with the iOfficeAI/OfficeCLI repository. As documented in the project's [`README.md`](https://github.com/iOfficeAI/OfficeCLI/blob/main/README.md) between lines 29 and 38, the maintainers provide platform-specific binaries for:

- macOS: `officecli-mac-arm64` (Apple Silicon) and `officecli-mac-x64` (Intel)
- Linux: `officecli-linux-x64` and `officecli-linux-arm64`
- Windows: `officecli-win-x64.exe` and `officecli-win-arm64.exe`

Each release tag (e.g., `v1.2.3`) contains these assets, allowing you to download specific versions manually using standard HTTP clients like `curl` or `wget`.

## Platform-Specific Download Instructions

### Linux (x64 and ARM64)

To download the Linux x64 binary manually:

```bash

# Replace vX.Y.Z with the latest release tag

curl -L -o officecli https://github.com/iOfficeAI/OfficeCLI/releases/download/vX.Y.Z/officecli-linux-x64

chmod +x officecli
sudo mv officecli /usr/local/bin/
officecli --version

```

For ARM64 systems, substitute `officecli-linux-arm64` in the URL.

### Windows (x64 and ARM64)

PowerShell users can fetch the binary with:

```powershell
Invoke-WebRequest -Uri "https://github.com/iOfficeAI/OfficeCLI/releases/download/vX.Y.Z/officecli-win-x64.exe" -OutFile "officecli.exe"

.\officecli.exe --help

```

Replace `vX.Y.Z` with the target version and `officecli-win-x64.exe` with `officecli-win-arm64.exe` for ARM64 devices.

### macOS (Apple Silicon and Intel)

For Apple Silicon Macs:

```bash
curl -L -o officecli https://github.com/iOfficeAI/OfficeCLI/releases/download/vX.Y.Z/officecli-mac-arm64

chmod +x officecli
./officecli --help

```

Intel Mac users should download `officecli-mac-x64` instead.

## Binary Architecture and Runtime Requirements

The OfficeCLI binaries are built as **self-contained single-file executables** that embed the .NET runtime directly into the executable. As implemented in the iOfficeAI/OfficeCLI repository, this architecture means:

- No separate .NET SDK or runtime installation is required
- The binary functions as a standalone executable immediately after download
- All dependencies are statically linked within the file

This design is consistent across all supported platforms, ensuring identical behavior whether you download the Linux x64 binary or the Windows executable.

## Alternative to Manual Download

While manual downloading from GitHub Releases provides full control over versioning and placement, the repository also provides automated installation scripts for convenience:

- **[`install.sh`](https://github.com/iOfficeAI/OfficeCLI/blob/main/install.sh)**: Bash script for Linux and macOS that detects the platform and downloads the appropriate binary
- **`install.ps1`**: PowerShell script for Windows with equivalent functionality
- **[`npm/officecli.js`](https://github.com/iOfficeAI/OfficeCLI/blob/main/npm/officecli.js)**: NPM wrapper that handles binary management when installing via Node.js package manager

These scripts automate the manual download process described above but perform the same underlying HTTP requests to the GitHub Releases page.

## Verification and Usage

After downloading, verify the binary works correctly:

```bash
officecli --version

```

Once confirmed, you can immediately execute OfficeCLI commands without further configuration:

```bash
officecli create report.pptx
officecli add report.pptx / --type slide --prop title="Quarterly Results"

```

## Summary

- **GitHub Releases** is the official manual download location for OfficeCLI binaries
- Binaries are available for macOS (Apple Silicon/Intel), Linux (x64/ARM64), and Windows (x64/ARM64)
- All binaries are self-contained with embedded .NET runtime—no additional dependencies required
- Download URLs follow the pattern: `https://github.com/iOfficeAI/OfficeCLI/releases/download/vX.Y.Z/[binary-name]`
- The [`README.md`](https://github.com/iOfficeAI/OfficeCLI/blob/main/README.md) (lines 29-38) serves as the authoritative source for the current binary filename matrix
- Manual download provides an alternative to the automated [`install.sh`](https://github.com/iOfficeAI/OfficeCLI/blob/main/install.sh), `install.ps1`, or NPM installation methods

## Frequently Asked Questions

### Can I download OfficeCLI binaries without using a package manager?

Yes. The iOfficeAI/OfficeCLI repository explicitly supports manual downloading via the GitHub Releases page. As documented in [`README.md`](https://github.com/iOfficeAI/OfficeCLI/blob/main/README.md), you can use `curl`, `wget`, or a web browser to download the self-contained binaries directly, bypassing the need for package managers like NPM, Homebrew, or APT.

### What is the difference between the ARM64 and x64 binaries?

The ARM64 binaries (`officecli-mac-arm64`, `officecli-linux-arm64`, `officecli-win-arm64.exe`) are compiled for ARM-based processors like Apple Silicon M1/M2/M3 chips or ARM64 servers. The x64 binaries target traditional Intel/AMD 64-bit processors. Download the version matching your CPU architecture for optimal performance.

### Do I need to install .NET separately after downloading the binary?

No. According to the OfficeCLI source code architecture, all binaries are published as **self-contained executables** that embed the .NET runtime internally. This design eliminates external dependencies, allowing the binary to run immediately after download and permission assignment (`chmod +x` on Unix systems).

### How do I check which version of OfficeCLI I downloaded?

Run the binary with the `--version` flag. For example, `./officecli --version` on Linux/macOS or `officecli.exe --version` on Windows. This outputs the version number that corresponds to the GitHub release tag (e.g., `v1.2.3`), confirming you have successfully downloaded the intended release.