Metadata-Version: 2.4
Name: sheafmodel
Version: 0.0.1a1
Summary: Bootstrap model catalog helpers for the SheafLab project.
Project-URL: Homepage, https://sheaflab.com
Project-URL: Repository, https://github.com/SheafLab/sheafmodel-python
Project-URL: Issues, https://github.com/SheafLab/sheafmodel-python/issues
Author: SheafLab
License: MIT
License-File: LICENSE
Keywords: catalog,llm,models,ranking,sheaflab
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# sheafmodel

`sheafmodel` is the official Python package namespace for lightweight model
catalog helpers used by the SheafLab project.

This initial public release focuses on a small but real surface: describing
model cards, filtering them by required capabilities, and ranking candidates by
cost, latency, and context-window constraints.

## Install

```bash
pip install sheafmodel
```

## Usage

```python
from sheafmodel import ModelCard, best_candidate, filter_by_capabilities

cards = [
    ModelCard(
        name="alpha-small",
        family="alpha",
        size="small",
        context_window=8192,
        modalities=("text",),
        capabilities=("chat", "summarization"),
        latency_score=2,
        cost_score=1,
    ),
]

chosen = best_candidate(cards, required=("chat",), min_context=4096)
```

## Status

- Project stage: pre-alpha
- Package scope: bootstrap model-catalog utilities only
- Main project site: https://sheaflab.com

