Skip to content

Foundry Local CLI 0.10.0 (Preview)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Wayne-Ch Wayne-Ch released this 04 Jun 20:35
cli-preview-0.10.0
4b430a4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Public preview of the Foundry Local CLI — the first release of the new CLI built on the Foundry Local SDKs, replacing the earlier service-based CLI.

Important

Preview. This is an early build — expect rough edges, missing polish, and changes between releases. Please file issues (tag titles with [cli]) for anything you hit.

What it's for

The Foundry Local CLI is the terminal entry point to Foundry Local: install and manage models, start and inspect the local server, run quick chat / completion / transcription tests, and pull diagnostics. It pairs with the SDK — the CLI is what you reach for from a terminal or script, the SDK is what you call from your app.

Install

Pick the asset for your platform from the downloads list below.

Platform Asset
Windows x64 foundry-0.10.0-win-x64-winml.msix (recommended) or -win-x64.msix
Windows ARM64 foundry-0.10.0-win-arm64-winml.msix (recommended) or -win-arm64.msix
macOS (Apple Silicon) foundry-0.10.0-osx-arm64.pkg
Linux x64 foundry-0.10.0-linux-x64.tar.gz
Linux ARM64 foundry-0.10.0-linux-arm64.tar.gz

On Windows and macOS you can also double-click the installer to install with the OS installer. The commands below are the scripted equivalents.

# Windows
Add-AppxPackage .\foundry-0.10.0-win-x64-winml.msix
foundry --version
# macOS
sudo installer -pkg foundry-0.10.0-osx-arm64.pkg -target /
foundry --version
# Linux
tar xzf foundry-0.10.0-linux-x64.tar.gz
./foundry/foundry --version

All binaries are signed by Microsoft Corporation. SHA-256 digests are shown on the asset list above (click an asset's filename).

Quick start

foundry status                                    # system info and service state
foundry model list                                # available models
foundry model load qwen3-0.6b                     # download (if needed) and load
foundry chat qwen3-0.6b                           # interactive chat
foundry transcribe -m whisper-tiny -f audio.wav   # transcribe a local audio file
foundry server stop                               # release the daemon when done

Most commands accept --output json for scripting. Run foundry --help for the full command surface.

Coming from the older Foundry Local CLI?

The earlier service-based CLI (required to use Foundry Local before the SDKs shipped) has been replaced. Common commands map roughly as follows:

Old (service-based CLI) New
foundry service start / stop / restart / ps / diag foundry server start / stop / restart / logs
foundry cache remove foundry cache rm
foundry model run <alias> foundry run <alias>
foundry model info <alias> foundry model show <alias>

Run foundry --help for the full surface.

Links

Feedback

File issues at https://github.com/microsoft/Foundry-Local/issues with the [cli] tag and include the output of foundry report.

Assets 10
Loading