v1.2.0

feyninc/chonkiev1.2.0Aug 28, 2025by chonknick

AI Summary

A major feature update introducing a new advanced SemanticChunker and support for multiple vector database handshakes.

Key Highlights

  • New `SemanticChunker` with advanced peak detection, `skip_window` support, and better thresholding.
  • Added `MongoDBHandshake`, `PineconeHandshake`, and `WeaviateHandshake` for direct database integration.

New Features

  • Advanced semantic chunking algorithm improvements.
  • New handshakes for MongoDB, Pinecone, and Weaviate.
  • Fixes for Weaviate cloud tests and OpenAI embeddings truncation.

Full Release Notes

<img width="712" height="499" alt="image" src="https://github.com/user-attachments/assets/0eb4c719-0048-4d41-9651-44c5fa7fb1be" />


## ✨ Highlights

- New `SemanticChunker` with advance peak detection, `skip_window` support, group embedding support and better thresholding! The new semantic chunker requires much less tuning for consistently sized chunks.

```python
# Import the chunker
from chonkie import SemanticChunker

# Initialize the chunker
chunker = SemanticChunker(chunk_size=512)

# define the text
text = ...

# CHONK!
chunk = chunker(text)
```

- Support for MongoDB via `MongoDBHandshake`!

```python
from chonkie import MongoDBHandshake, SemanticChunker

# Initialize the handshake
handshake = MongoDBHandshake(uri="mongodb://localhost:8080", db_name="my_documents")

# Create some chunks
chunker = SemanticChunker()
chunks = chunker.chunk("Chonkie loves to chonk your texts!")

# Write chunks to MongoDB
handshake.write(chunks)
```

- Support for Pinecone via `PineconeHandshake`!

```python
from chonkie import PineconeHandshake, SemanticChunker

# Initialize the handshake
handshake = PineconeHandshake(api_key=...)

# Create some chunks
chunker = SemanticChunker()
chunks = chunker.chunk("Chonkie loves to chonk your texts!")

# Write chunks to Pinecone
handshake.write(chunks)
```

- Support for Weaviate via `WeaviateHandshake`!

```python
from chonkie import WeaviateHandshake, SemanticChunker

# Initialize the handshake
handshake = WeaviateHandshake(url=url, api_key=...)

# Create some chunks
chunker = SemanticChunker()
chunks = chunker.chunk("Chonkie loves to chonk your texts!")

# Write chunks to Weaviate
handshake.write(chunks)
```


## What's Changed
* Fix: Update README — Absolute path for logo by @chonk-lain in https://github.com/chonkie-inc/chonkie/pull/235
* Update README.md — Add recent integrations to the list by @chonknick in https://github.com/chonkie-inc/chonkie/pull/237
* docs: fix url by @superpung in https://github.com/chonkie-inc/chonkie/pull/240
* Support weaviate by @xucailiang in https://github.com/chonkie-inc/chonkie/pull/204
* Fix: Remove failing weaviate cloud tests from CI/CD by @chonknick in https://github.com/chonkie-inc/chonkie/pull/246
* Fix: Add `_truncate` to the `OpenAIEmbddings` (#239) by @chonknick in https://github.com/chonkie-inc/chonkie/pull/247
* Feat: Add `PineconeHandshake` by @chonk-lain in https://github.com/chonkie-inc/chonkie/pull/243
* docs: updated handshakes overview and move changelog to Python SDK by @sahibpreetsingh12 in https://github.com/chonkie-inc/chonkie/pull/255
* Feat: Add `MongoDBHandshake` by @chonk-lain in https://github.com/chonkie-inc/chonkie/pull/253
* Feat: Add better `SemanticChunker` with peak finding, window similarities and more! by @chonknick in https://github.com/chonkie-inc/chonkie/pull/251
* Migrate the cookbook to `chonkie-inc/cookbook` by @chonknick in https://github.com/chonkie-inc/chonkie/pull/258
* Docs: update mongodb docs by @chonk-lain in https://github.com/chonkie-inc/chonkie/pull/259

## New Contributors
* @chonk-lain made their first contribution in https://github.com/chonkie-inc/chonkie/pull/235
* @superpung made their first contribution in https://github.com/chonkie-inc/chonkie/pull/240
* @xucailiang made their first contribution in https://github.com/chonkie-inc/chonkie/pull/204
* @sahibpreetsingh12 made their first contribution in https://github.com/chonkie-inc/chonkie/pull/255

**Full Changelog**: https://github.com/chonkie-inc/chonkie/compare/v1.1.2...v1.2.0