Foundry Local CLI 0.10.3 (Preview)
Pre-releasePublic preview update for the Foundry Local CLI.
Important
Preview. This is an early CLI build. Expect rough edges, missing polish, and changes between releases. Please file issues with [cli] in the title and include foundry report output when possible.
What's New
Updated Foundry Local SDK
This build updates the Foundry Local SDK packages to 1.2.4 to fix issues with EP downloads and non-CPU models not showing up
⚡ Improvements
- Write more detailed logs from Foundry Local Core
- Add end-to-end cancellation support
- Show package versions and accurate vRAM value in foundry status
Install
Pick the asset for your platform from the downloads list below.
| Platform | Asset |
|---|---|
| Windows x64 | foundry-0.10.3-win-x64-winml.msix recommended, or foundry-0.10.3-win-x64.msix |
| Windows ARM64 | foundry-0.10.3-win-arm64-winml.msix recommended, or foundry-0.10.3-win-arm64.msix |
| macOS Apple Silicon | foundry-0.10.3-osx-arm64.pkg |
| Linux x64 | foundry-0.10.3-linux-x64.tar.gz |
| Linux ARM64 | foundry-0.10.3-linux-arm64.tar.gz |
# Windows
Add-AppxPackage .\foundry-0.10.3-win-x64-winml.msix
foundry --version# macOS
sudo installer -pkg foundry-0.10.3-osx-arm64.pkg -target /
foundry --version# Linux
tar xzf foundry-0.10.3-linux-x64.tar.gz
cd foundry-0.10.3-linux-x64
./lib/foundry --versionAll binaries are signed by Microsoft Corporation. SHA-256 digests are shown on the asset list above.
Quick Start
foundry status
foundry model list
foundry model load qwen3-0.6b
foundry chat qwen3-0.6b
foundry transcribe -m whisper-tiny -f audio.wav
foundry server stop
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 has been replaced. Common commands map roughly as follows:
| Old service-based CLI | New CLI |
|---|---|
foundry service start / stop / restart / ps / diag |
foundry server start / stop / restart / logs |
foundry model run <alias> |
foundry run <alias> |
Run foundry --help for the full surface.
Links
- Docs: https://aka.ms/foundry-local-docs
- SDK: https://github.com/microsoft/Foundry-Local/tree/main/sdk
- Discord: https://aka.ms/foundry-local-discord
- Issues: https://github.com/microsoft/Foundry-Local/issues
Feedback
File issues at https://github.com/microsoft/Foundry-Local/issues with [cli] in the title and include the output of foundry report.