Skip to main content
By default, Chonkie logs warnings and errors. You can control what gets logged using the CHONKIE_LOG environment variable or configure it programmatically.

Quick Setup

Set the CHONKIE_LOG environment variable before importing chonkie:

Programmatic Configuration

Configure logging from your Python code:

Log Levels

  • debug - Everything (chunker initialization, text processing, chunk counts)
  • info - High-level operations (chunk creation, file operations)
  • warning - Potential issues (default)
  • error - Only errors
  • off - Silent

Custom Format

Change the log format to suit your needs:
Output:
That’s it. Logging is simple and stays out of your way.