Skip to content

v0.3.0 (June, 2025)

Choose a tag to compare

@jeremymanning jeremymanning released this 13 Jun 15:07
· 33 commits to main since this release

🎉 Major Release: NumPy 2.0+ Compatibility & Modern ML Libraries

This release brings full compatibility with NumPy 2.0+ and pandas 2.0+ while modernizing the text embedding infrastructure with sentence-transformers.

🚀 New Features

  • Full NumPy 2.0+ and pandas 2.0+ compatibility
  • Modern sentence-transformers integration for text embeddings
  • Support for latest scikit-learn, matplotlib, and scipy versions
  • Enhanced error handling for missing dependencies
  • Updated Python support (3.9-3.12)

🔧 Breaking Changes

  • Replaced Flair with sentence-transformers for text embeddings
  • Removed gensim dependency (eliminates NumPy version conflicts)
  • Updated text embedding API to use sentence-transformers models
  • Dropped Python 3.6-3.8 support in favor of modern Python versions

🐛 Bug Fixes

  • Fixed numpy.str_ deprecation that broke in NumPy 2.0+
  • Updated HuggingFace datasets import for API changes
  • Fixed sklearn model detection preventing incorrect sentence-transformers usage
  • Fixed pandas iteritems deprecation for pandas 2.0+ compatibility
  • Replaced deprecated matplotlib.pyplot.imread

📚 Documentation & Examples

  • Updated all examples to use sentence-transformers syntax
  • Modernized installation instructions and model references
  • Comprehensive tutorial updates with new embedding approaches

🔄 Migration Guide

Old Flair syntax:
{'model': 'TransformerDocumentEmbeddings', 'args': ['bert-base-uncased']}

New sentence-transformers syntax:
{'model': 'all-mpnet-base-v2', 'args': [], 'kwargs': {}}

🛠️ Technical Changes

  • Sklearn models (CountVectorizer, etc.) now properly detected before sentence-transformers
  • Enhanced model detection prevents accidental model misclassification
  • Improved error messages for missing optional dependencies
  • Full compatibility with modern scientific Python stack