Skip to content

Conversation

@qgallouedec
Copy link
Member

image

@tomaarsen tomaarsen linked an issue Dec 5, 2025 that may be closed by this pull request
)


class NeptuneCallback(TrainerCallback):
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not very familiar with the modern transformers deprecation approach, but do we have a nice decorator here that can inform IDE's that objects are deprecated, perhaps?
image

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR deprecates the Neptune integration in Transformers by removing documentation references and adding deprecation warnings to the NeptuneCallback class. The callback remains functional to support existing users, but will warn them to migrate to alternative experiment tracking integrations.

Key Changes

  • Added deprecation warnings (docstring and runtime) to NeptuneCallback class
  • Removed Neptune from the list of supported integrations in TrainingArguments documentation
  • Removed Neptune setup guide and examples from PyTorch examples README
  • Removed Neptune callback references from documentation across multiple languages (English, Korean, Japanese, Chinese)

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/transformers/training_args.py Removed "neptune" from the list of supported platforms in report_to parameter documentation (2 locations)
src/transformers/integrations/integration_utils.py Added warnings import and deprecation warning to NeptuneCallback.__init__() with corresponding docstring warning
examples/pytorch/README.md Removed complete Neptune integration section including installation instructions, usage examples, and environment variable documentation
docs/source/en/main_classes/callback.md Removed NeptuneCallback reference from list of available callbacks and removed autodoc entry
docs/source/zh/main_classes/callback.md Removed NeptuneCallback reference from list of available callbacks and removed autodoc entry (Chinese documentation)
docs/source/ko/main_classes/callback.md Removed NeptuneCallback reference from list of available callbacks and removed autodoc entry (Korean documentation)
docs/source/ja/main_classes/callback.md Removed NeptuneCallback reference from list of available callbacks and removed autodoc entry (Japanese documentation)

@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

Copy link
Member

@SunMarc SunMarc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM ! Thanks for the PR

Comment on lines +1508 to +1512
warnings.warn(
"The NeptuneCallback is deprecated and will be removed in a future version of Transformers. We recommend "
"using other supported experiment tracking integrations.",
FutureWarning,
)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks ! We can keep this deprecation message for now as it still works but I've checked that their services will go down on after a 3‑month transition period ending on March 5, 2026. We can remove it after this date !

@SunMarc SunMarc merged commit 8eef4bb into main Dec 8, 2025
25 checks passed
@SunMarc SunMarc deleted the deprecated-neptune branch December 8, 2025 13:38
leaderofARS pushed a commit to leaderofARS/transformers that referenced this pull request Dec 9, 2025
…huggingface#42666)

Remove Neptune integration references and deprecate NeptuneCallback
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Deprecate NeptuneCallback

5 participants