The Implementation for Bring Your Own Local Model (BYOM) API

[Selena Yang (selenayang888)]

The implementation to register a local ONNX model from an arbitrary filesystem path and make it available through the standard Catalog/Model/Inference api.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
foundry-local	Ready	Preview	Aug 7, 2026 11:38pm

[Copilot]

Pull request overview

Adds persistent registration and inference support for local ONNX models through new local catalog and C/C++ APIs.

Changes:

• Adds local model registration, persistence, metadata, and lifecycle handling.
• Extends versioned C/C++ APIs with catalog selection and mutable ModelInfo.
• Adds unit tests and separates legacy cached models from explicitly registered BYOM models.

Reviewed changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
sdk_v2/cpp/test/internal_api/model_info_test.cc	Tests property-bag persistence.
sdk_v2/cpp/test/internal_api/model_info_accessors_test.cc	Tests ModelInfo copy semantics.
sdk_v2/cpp/test/internal_api/local_model_catalog_test.cc	Tests local catalog behavior.
sdk_v2/cpp/test/internal_api/c_api_test.cc	Tests versioned cloning API.
sdk_v2/cpp/test/internal_api/azure_catalog_test.cc	Updates unresolved-cache expectations.
sdk_v2/cpp/test/CMakeLists.txt	Adds local catalog tests.
sdk_v2/cpp/src/model.h	Adds local-model lifecycle state.
sdk_v2/cpp/src/model.cc	Implements local loading and unregistering.
sdk_v2/cpp/src/model_info.h	Declares property-bag utilities.
sdk_v2/cpp/src/model_info.cc	Implements property persistence.
sdk_v2/cpp/src/manager.h	Adds multiple catalog support.
sdk_v2/cpp/src/manager.cc	Creates public and local catalogs.
sdk_v2/cpp/src/inferencing/session/session.cc	Uses collision-safe runtime IDs.
sdk_v2/cpp/src/inferencing/generative/genai_model_instance.cc	Revises provider overrides.
sdk_v2/cpp/src/catalog/local_model_catalog.h	Defines the local catalog.
sdk_v2/cpp/src/catalog/local_model_catalog.cc	Implements registration persistence.
sdk_v2/cpp/src/catalog/catalog_client.h	Documents explicit BYOM registration.
sdk_v2/cpp/src/catalog/catalog_client.cc	Removes synthesized BYOM entries.
sdk_v2/cpp/src/catalog/base_model_catalog.h	Adds catalog types and tombstones.
sdk_v2/cpp/src/catalog/base_model_catalog.cc	Implements model deactivation.
sdk_v2/cpp/src/catalog/azure_model_catalog.cc	Filters legacy local entries.
sdk_v2/cpp/src/catalog.h	Extends the catalog interface.
sdk_v2/cpp/src/c_api.cc	Implements versioned BYOM C APIs.
sdk_v2/cpp/include/foundry_local/foundry_local_cpp.inline.h	Implements C++ wrappers.
sdk_v2/cpp/include/foundry_local/foundry_local_cpp.h	Exposes new C++ APIs.
sdk_v2/cpp/include/foundry_local/foundry_local_c.h	Defines C API v3.
sdk_v2/cpp/CMakeLists.txt	Builds the local catalog source.