docs: Add blog post draft

.github/workflows/test.yml

@@ -44,7 +44,7 @@ jobs:
 
     - name: Install Python dependencies
       run: |
-        uv venv .venv --python 3.12
+        uv venv .venv --python 3.12 --clear
         uv build
         source .venv/bin/activate
         uv pip install ./dist/sieves-*.whl

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to LLM agents when working with code in this repository.
 
 ---
 
@@ -49,7 +49,7 @@ AGENTS.md                  # This file (Claude Code guidelines)
 
 ## Installation & Setup
 
-**Python requirement:** 3.12 (exact version required)
+**Python requirement:** 3.12 or 3.13 (3.14 not supported yet due to dependency wheels missing)
 
 ### Using `uv` (preferred)
 
@@ -377,7 +377,6 @@ Before proposing changes, ensure:
 - **All model libraries** (Outlines, DSPy, LangChain, Transformers, GLiNER2) are **core dependencies**
 - Serialization excludes complex third-party objects (models, converters); must pass at load time
 - Ingestion tasks may require system packages (Tesseract for OCR, etc.)
-- Python 3.12 exact version required (not 3.12+)
 
 ---
 

README.md

@@ -11,7 +11,7 @@
 
 
 [![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/mantisai/sieves/test.yml)](https://github.com/mantisai/sieves/actions/workflows/test.yml)
-![GitHub top language](https://img.shields.io/github/languages/top/mantisai/sieves)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sieves)
 [![Version](https://img.shields.io/github/v/release/mantisai/sieves?include_prereleases&label=version)](https://github.com/mantisai/sieves/releases)
 ![Status](https://img.shields.io/badge/status-beta-blue)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/ambv/black)
@@ -24,7 +24,7 @@
 
 <br>
 
-## A Unified Interface for Document AI.
+## A Unified Interface for Structured Document AI.
 
 `sieves` provides a **framework-agnostic abstraction for building document AI pipelines**.
 
@@ -89,7 +89,6 @@ to skip having to define tasks from scratch.
 ```bash
 pip install sieves
 ```
-*Requires Python 3.12 (due to dependency constraints in `docling` and `pyarrow`).*
 
 **2. Basic: text classification with a small local model**
 

docs/examples/crisis_tweets.md

@@ -0,0 +1,3 @@
+# Crisis Tweet Analysis
+
+<iframe src="../crisis_tweets_raw.html" width="100%" height="1000px" frameborder="0"></iframe>

mkdocs.yml

@@ -1,8 +1,8 @@
-site_name: sieves
+site_name: Sieves
 site_url: https://sieves.ai/docs
 docs_dir: docs
 repo_url: https://github.com/mantisai/sieves
-repo_name: "sieves on GitHub"
+repo_name: "<code>sieves</code> on GitHub"
 
 theme:
   name: material
@@ -93,3 +93,5 @@ nav:
       - guides/optimization.md
       - guides/distillation.md
       - guides/observability.md
+  - Examples:
+      - examples/crisis_tweets.md

pyproject.toml

@@ -15,7 +15,7 @@ authors = [
     { name = "Angelo Di Gianvito", email = "hi@mantisnlp.com" },
 ]
 dynamic = ["version"]
-requires-python = "==3.12.*"
+requires-python = ">=3.12,<3.14"
 dependencies = [
     "chonkie>=1,<2",
     "datasets>=3,<4",
@@ -45,7 +45,8 @@ classifiers = [
     "Topic :: Software Development :: Libraries",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12"
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13"
 ]
 
 [project.urls]

sieves/model_wrappers/dspy_.py

@@ -54,7 +54,7 @@ def __init__(self, model: Model, model_settings: ModelSettings):
         """
         super().__init__(model, model_settings)
         cfg = model_settings.config_kwargs or {}
-        dspy.configure(lm=model, track_usage=True, **cfg)
+        dspy.configure(lm=model, **({"track_usage": True} | cfg))
 
         # Disable noisy LiteLLM logging.
         dspy.disable_litellm_logging()

sieves/tests/tasks/predictive/test_summarization.py

@@ -174,4 +174,4 @@ def test_evaluation(batch_runtime) -> None:
     doc_partial.results["sum"] = Result(summary="A fox jumps.", score=1.0)
     doc_partial.gold["sum"] = Result(summary="The quick brown fox jumps over the lazy dog.", score=1.0)
     report_partial = task.evaluate([doc_partial], judge=batch_runtime.model)
-    assert 0.2 <= report_partial.metrics[task.metric] <= 0.8
+    assert 0.4 <= report_partial.metrics[task.metric] <= 0.9