docs: Add blog post draft (#252)

* docs: Update readme, agents.md.

* docs: Add first draft of blog post.

* docs: Second draft of blog post.

* docs: Include PyData link in blog post.

* chore: Stylize as `sieves` in header elements.

* chore: Stylize as Sieves in header elements.

* docs: Embed crisis tweet example in docs.

* chore: Extend official Python support to >=3.13,<3.14.

* chore: Move blog post to docs/.

* test: Relax test thresholds.

* feat: Allow overwriting track_usage flag for dspy.configure.

* docs: Remove top language badge, add Python version badge.

* docs: Add images to blog post.

* docs: Fix Mermaid diagram.

* docs: Fix Mermaid diagram.

* docs: Fix Mermaid diagram.

* docs: Fix Mermaid diagram.

* docs: Rephrase mix-and-match description.

* docs: Rephrase mix-and-match description.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* docs: Update blog draft.

* fix: Use --clear for venv creation.

---------

Co-authored-by: Raphael Mitsch <raphael@climatiq.com>

Author: rmitsch

.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/assets/pipeline.png

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

docs/assets/pipeline.svg

@@ -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