Skip to content

refactor!: remove deprecated Eval API and related APIs#5290

Draft
leseb wants to merge 18 commits intollamastack:mainfrom
leseb:remove-eval-api
Draft

refactor!: remove deprecated Eval API and related APIs#5290
leseb wants to merge 18 commits intollamastack:mainfrom
leseb:remove-eval-api

Conversation

@leseb
Copy link
Copy Markdown
Collaborator

@leseb leseb commented Mar 25, 2026

Summary

Remove the Eval API and all connected APIs that are already marked deprecated in the spec:

  • /v1alpha/eval/ (benchmarks, jobs, evaluations)
  • /v1beta/datasets/ (dataset CRUD)
  • /v1alpha/scoring/ (scoring functions, scoring)
  • /v1alpha/post-training/ (post training jobs)

These were marked experimental/deprecated and are not part of the v1 API surface.

What changed

  • Removed provider registry entries for eval, scoring, post_training, datasetio
  • Removed inline/remote provider implementations
  • Removed routing tables and routers
  • Removed API models, protocols, and FastAPI routes from llama_stack_api
  • Removed distribution config entries
  • Updated tests: replaced benchmark_id tests with vector_store_id/shield_id, removed braintrust lazy import test
  • Removed starter-gpu distribution (leftover from merge)
  • Disabled external provider CI test (lmeval depends on eval API - switched to workflow_dispatch only until a suitable replacement is found)

Migration

Users of the eval API should use external evaluation frameworks (eval-hub, RAGAS, DeepEval) directly. The datasetio provider for HuggingFace datasets can be accessed via the HuggingFace datasets library.

Test plan

  • Unit tests pass (replaced benchmark tests with vector_store/shield tests)
  • Pre-commit passes
  • starter-gpu distribution removed
  • External provider CI test disabled (was using lmeval)

🤖 Generated with Claude Code

…o, scoring, scoring_functions, benchmarks)

Remove the Eval API and all connected APIs that were already marked as
deprecated in the spec. This includes the datasets, datasetio, scoring,
scoring_functions, and benchmarks APIs along with all their provider
implementations, routing tables, routers, registry entries, distribution
configs, and tests.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@meta-cla meta-cla bot added the CLA Signed This label is managed by the Meta Open Source bot. label Mar 25, 2026
@leseb leseb added this to the 0.8.0 milestone Mar 25, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 25, 2026

✱ Stainless preview builds

This PR will update the llama-stack-client SDKs with the following commit message.

refactor!: remove deprecated Eval API and related APIs

Edit this comment to update it. It will appear in the SDK's changelogs.

llama-stack-client-go studio · conflict

Your SDK build had at least one new note diagnostic, which is a regression from the base state.

New diagnostics (1 note)
💡 Model/Recommended: `#/components/schemas/ImageContentItem` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/$shared`.
llama-stack-client-python studio · conflict

Your SDK build had at least one new note diagnostic, which is a regression from the base state.

New diagnostics (1 note)
💡 Model/Recommended: `#/components/schemas/ImageContentItem-Input` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_io`.
llama-stack-client-openapi studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️

New diagnostics (1 note)
💡 Model/Recommended: `#/components/schemas/ImageContentItem-Input` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_io`.
llama-stack-client-node studio · conflict

Your SDK build had at least one new note diagnostic, which is a regression from the base state.

New diagnostics (1 note)
💡 Model/Recommended: `#/components/schemas/ImageContentItem-Input` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_io`.

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-04-01 16:10:12 UTC

@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 25, 2026

This pull request has merge conflicts that must be resolved before it can be merged. @leseb please rebase it. https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

Signed-off-by: Sébastien Han <seb@redhat.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 26, 2026

This pull request has merge conflicts that must be resolved before it can be merged. @leseb please rebase it. https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify bot added the needs-rebase label Mar 26, 2026
…nses rename

Merge upstream/main into remove-eval-api branch, resolving conflicts caused
by the agents-to-responses API rename (PR llamastack#5195) interacting with the eval API
removal. This includes fixing distribution templates that still referenced the
old "agents" API name, removing the stale DatasetPurpose import from
template.py, cleaning up the stainless config to remove references to deleted
eval/scoring/dataset endpoints, removing the now-orphaned nvidia datasetio
test, and regenerating all OpenAPI specs and distribution configs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@mergify mergify bot removed the needs-rebase label Mar 26, 2026
leseb and others added 5 commits March 26, 2026 21:05
Resolve merge conflicts from upstream/main. All modify/delete conflicts
are resolved by keeping the deletions from this branch since the purpose
of this branch is to remove the eval, scoring, datasetio, and benchmarks
APIs. Content conflicts in datatypes.py files are resolved by excluding
the eval-related classes that upstream added.

Signed-off-by: Sébastien Han <seb@redhat.com>
Merge upstream/main into remove-eval-api branch. The Dell distribution
was removed upstream, so the conflicting Dell files (config.yaml,
dell.py, run-with-safety.yaml) are resolved by accepting the upstream
deletion.

Signed-off-by: Sebastien Han <seb@redhat.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
Merge upstream/main into remove-eval-api branch. The only conflict was
in ifeval_utils.py which was modified upstream but deleted in this branch
as part of the eval API removal. Kept the deletion since this branch
removes the eval, scoring, datasetio, and benchmarks APIs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
These ifeval utility files were reintroduced during the merge with
upstream/main. They belong to the scoring provider which was removed
as part of the eval API removal in this branch.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 30, 2026

This pull request has merge conflicts that must be resolved before it can be merged. @leseb please rebase it. https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify bot added the needs-rebase label Mar 30, 2026
Merge upstream/main into remove-eval-api branch. All conflicts were
modify/delete type where upstream modified files that this branch
intentionally deleted as part of removing the Eval, DatasetIO, Scoring,
and Benchmarks APIs. Resolved by keeping the deletions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@mergify mergify bot removed the needs-rebase label Mar 30, 2026
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 30, 2026

This pull request has merge conflicts that must be resolved before it can be merged. @leseb please rebase it. https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify bot added the needs-rebase label Mar 30, 2026
leseb and others added 2 commits March 30, 2026 16:46
Merge upstream/main into remove-eval-api branch, resolving conflicts in
the deprecated OpenAPI spec file by keeping the branch version which
excludes eval-related deprecated endpoints (scoring functions, datasets,
benchmarks) consistent with the purpose of this branch.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
The pre-commit OpenAPI codegen hook updated the deprecated spec file to
match the current state of the codebase after merging upstream/main.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
@mergify mergify bot removed the needs-rebase label Mar 30, 2026
leseb and others added 3 commits March 31, 2026 11:44
Replace benchmark_id tests with vector_store_id and shield_id since
benchmark_id was removed from RESOURCE_ID_FIELDS with the eval API.

Remove braintrust lazy import test since the braintrust scoring provider
was removed along with the eval API.

Switch external provider CI test from lmeval (which depends on eval API)
to the weather/kaze external provider which has no eval dependency.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
leseb and others added 3 commits March 31, 2026 13:56
The starter-gpu distribution was removed in PR llamastack#5279 but survived the
merge into this branch. Remove the leftover directory so CI no longer
attempts to build it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
Take upstream's auto-discovery approach for router factories which
dynamically discovers routers from the Api enum. Since this branch
already removed eval-related APIs from the Api enum, the auto-discovery
naturally excludes them without needing an explicit static list.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
The lmeval external provider depends on the eval API which is being
removed. The weather/kaze provider works but needs further validation.
Disable the workflow until we find a suitable external provider for CI.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant