microsoft/Foundry-Local v1.0.0

v1.0.0 Foundry Local - General Availability

on GitHub

We are excited to announce the General Availability of Foundry Local, a unified on-device AI runtime that brings generative AI directly into your applications. All inference runs locally: user data never leaves the device, responses are instant with zero network latency, and everything works offline. No per-token costs, no backend infrastructure.

SDKs

Foundry Local ships production SDKs for C#, JavaScript, Python, and Rust, each providing a consistent API surface for model management, chat completions, audio transcription, and tool calling.

	SDK	Package
	C#	Microsoft.AI.Foundry.Local
	JavaScript	foundry-local-sdk
🐍	Python	foundry-local-sdk
🦀	Rust	foundry-local-sdk

WinML Variants

Each SDK also ships a WinML variant that unlocks more GPU and NPU devices on Windows, available through the Windows ML execution provider catalog.

	SDK	Package
	C#	Microsoft.AI.Foundry.Local.WinML
	JavaScript	foundry-local-sdk-winml
🐍	Python	foundry-local-sdk-winml
🦀	Rust	foundry-local-sdk with winml feature flag

Platform Support

	OS	Architectures
	Windows	x64, ARM64
	macOS	ARM64
	Linux	x64

What You Can Build

Chat Completions

Full OpenAI-compatible chat completions API with multi-turn conversations, and configurable inference parameters (temperature, top-k, top-p, max tokens, frequency/presence penalty, random seed).

Audio Transcription

On-device speech-to-text. Transcribe audio files with language selection and temperature control.

Embedded Web Server

Start an OpenAI-compatible HTTP server from your application with a single call. Useful for multi-process architectures or bridging to tools that speak the OpenAI REST protocol.

Hardware Acceleration

Powered by ONNX Runtime, Foundry Local automatically detects available hardware and selects the best execution provider, with zero hardware detection code needed in your application.

Supported execution providers:

Execution providers can be discovered, downloaded, and registered at runtime through the SDK's discoverEps() and downloadAndRegisterEps() APIs, with per-provider progress callbacks.

Model Catalog & Management

Foundry Local includes a built-in model catalog with popular open-source models, optimized with state-of-the-art quantization and compression for on-device performance.

Model management features:

• Browse & search the catalog programmatically
• Multi-variant models - each alias maps to multiple variants optimized for different hardware (CPU, GPU, NPU)
• Automatic variant selection - the SDK picks the best variant based on what's cached and what hardware is available, with manual override via selectVariant()
• Download with progress tracking - real-time percentage callbacks
• Load / unload lifecycle - explicit control over which models are in memory
• Version management - query the catalog for the latest version of any model

Get Started

• Documentation and Samples