Last modified: Jun 20, 2025 By Alexander Williams

How to Uninstall Hugging Face Transformers

Hugging Face Transformers is a popular library for NLP tasks. Sometimes, you may need to uninstall it. This guide will help you remove it properly.

Why Uninstall Transformers?

You might need to uninstall Transformers for several reasons. These include freeing up space, fixing conflicts, or upgrading to a newer version.

Improper uninstallation can cause issues. Follow these steps to ensure a clean removal.

Check Installed Version

First, verify if Transformers is installed. Use the pip show command.

 
pip show transformers


Name: transformers
Version: 4.26.1
Summary: State-of-the-art Machine Learning for JAX, PyTorch and TensorFlow

Uninstall Transformers Using Pip

The easiest way to uninstall is with pip uninstall. Run this command in your terminal.

 
pip uninstall transformers


Successfully uninstalled transformers-4.26.1

Note: This removes the main package but not dependencies. You may need to uninstall them separately.

Remove Dependencies

Transformers has many dependencies. Some may not be needed after uninstallation. Check and remove unused ones.

For example, you might want to uninstall PyTorch or uninstall TensorFlow if they were only used with Transformers.

Verify Uninstallation

After uninstalling, verify it's removed. Try importing it in Python.

 
import transformers


ModuleNotFoundError: No module named 'transformers'

This error confirms successful uninstallation.

Clean Up Residual Files

Sometimes, pip leaves behind configuration files. Manually check these directories:

  • site-packages/transformers
  • ~/.cache/huggingface

Delete any remaining files or folders related to Transformers.

Reinstall if Needed

If you uninstalled by mistake, reinstall easily. Use the pip install command.

 
pip install transformers

For specific versions, add the version number.

Troubleshooting

If you face issues during uninstallation, try these:

  • Use pip install --force-reinstall before uninstalling
  • Run pip with administrator privileges
  • Check for multiple Python installations

For similar guides, see how to uninstall scikit-learn.

Conclusion

Uninstalling Hugging Face Transformers is straightforward. Use pip uninstall and clean up residual files. Always verify the uninstallation.

This ensures a clean environment for other projects. Remember to manage dependencies properly to avoid conflicts.