predikit 0.6.1__tar.gz → 0.6.3__tar.gz

{predikit-0.6.1 → predikit-0.6.3}/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,38 +1,38 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

{predikit-0.6.1 → predikit-0.6.3}/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,20 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

{predikit-0.6.1 → predikit-0.6.3}/.github/workflows/publish.yml

@@ -1,31 +1,31 @@
-name: Publish to PyPI
-
-on:
-  release:
-    types: [published]
-
-permissions:
-  contents: read
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      contents: read
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Build
-        run: |
-          pip install hatchling
-          python -m hatchling build
-
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: |
+          pip install hatchling
+          python -m hatchling build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{predikit-0.6.1 → predikit-0.6.3}/.github/workflows/test.yml

@@ -1,56 +1,56 @@
-name: Test
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install dev dependencies
-        run: pip install -e ".[dev]"
-
-      - name: Ruff lint
-        run: ruff check src/ tests/
-
-      - name: Ruff format check
-        run: ruff format --check src/ tests/
-
-      - name: Mypy
-        run: mypy src/predikit
-
-      - name: Build package
-        run: |
-          python -m pip install hatchling
-          python -m hatchling build
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        run: pip install -e ".[dev]"
-
-      - name: Run tests
-        run: pytest --cov=src/predikit --cov-report=term-missing
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: ruff check src/ tests/ examples/
+
+      - name: Ruff format check
+        run: ruff format --check src/ tests/ examples/
+
+      - name: Mypy
+        run: mypy src/predikit
+
+      - name: Build package
+        run: |
+          python -m pip install hatchling
+          python -m hatchling build
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --cov=src/predikit --cov-report=term-missing

predikit-0.6.3/.gitignore

@@ -0,0 +1,33 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+
+# Distribution / packaging
+build/
+dist/
+*.egg
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# Tooling caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# Test coverage
+.coverage
+coverage.xml
+htmlcov/
+
+# Serialized models written by examples and CLI tests
+*.joblib
+*.pkl
+
+# MLflow local tracking store
+mlruns/
+
+# Per-developer editor and agent settings
+.claude/settings.local.json

{predikit-0.6.1 → predikit-0.6.3}/.pre-commit-config.yaml

@@ -1,15 +1,15 @@
-repos:
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.5.0
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.0
-    hooks:
-      - id: mypy
-        additional_dependencies:
-          - pydantic>=2.0
-          - numpy>=1.24
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.0
+          - numpy>=1.24

{predikit-0.6.1 → predikit-0.6.3}/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [0.6.3] - 2026-09-13
+
+### Fixed
+- Corrected the MCP quick-start command: `predikit serve` requires both the `mcp` and `cli` extras. The MCP library API itself remains available with `predikit[mcp]` alone.
+
+### Changed
+- Polished the README installation guidance and documented MCP HTTP host/port options.
+
+## [0.6.2] - 2026-08-22
+
+### Added
+- `py.typed` marker, so type checkers actually consume the annotations. Every module is annotated and mypy-clean, and the package declares the `Typing :: Typed` classifier, but without the PEP 561 marker downstream consumers got no type information at all.
+
+### Changed
+- `from_snowflake()` imports `snowflake.ml.registry` inside the function body instead of at module level, matching `from_mlflow()` and the project's own rule for optional dependencies. The module-level `Registry = None` sentinel is gone.
+- CI lints and format-checks `examples/` alongside `src/` and `tests/`.
+
+### Removed
+- `uv.lock`. Nothing consumed it — CI installs with `pip install -e ".[dev]"` — and a library should not pin its consumers' transitive dependencies.
+- `.claude/settings.local.json` from version control. It holds per-developer machine paths.
+
 ## [0.6.1] - 2026-08-15
 
 ### Fixed

{predikit-0.6.1 → predikit-0.6.3}/CLAUDE.md

@@ -1,71 +1,71 @@
-# predikit — Claude Code context
-
-## What this is
-
-predikit wraps fitted scikit-learn / XGBoost models as LLM-callable tools with auto-generated JSON schemas, typed I/O via Pydantic, and first-class support for OpenAI function calling and LangChain.
-
-## Project layout
-
-```
-src/predikit/          Core package (installed as `predikit`)
-  tool.py              ModelTool — main public class
-  registry.py          ToolRegistry — groups multiple tools for bulk export
-  ensemble.py          ModelEnsemble — multi-model reconciliation strategies
-  exceptions.py        LowConfidenceError
-  coerce.py            LLM-string → Python type coercion (bool, int, float, str)
-  introspect.py        Extract sklearn model metadata (feature names, task type)
-  cli.py               `predikit inspect` CLI (click + joblib)
-  exporters/
-    openai.py          .to_openai() — OpenAI function-calling schema
-    langchain.py       .to_langchain() — LangChain StructuredTool
-  loaders/
-    mlflow.py          from_mlflow() — load from MLflow Model Registry
-    snowflake.py       from_snowflake() — load from Snowflake Model Registry
-tests/                 pytest suite (mirrors src/ layout)
-examples/              Standalone usage scripts (01–07)
-```
-
-## Commands
-
-```bash
-# Install for development
-pip install -e ".[dev]"
-
-# Run tests
-pytest --cov=src/predikit --cov-report=term-missing
-
-# Lint (check only)
-ruff check src/ tests/
-
-# Format (check only)
-ruff format --check src/ tests/
-
-# Lint + format (auto-fix)
-ruff check --fix src/ tests/
-ruff format src/ tests/
-
-# Type check
-mypy src/predikit
-
-# All checks via pre-commit
-pre-commit run --all-files
-
-# Install pre-commit hooks
-pre-commit install
-```
-
-## Key conventions
-
-- **Public API** — `ModelTool`, `ToolRegistry`, `ModelEnsemble`, `LowConfidenceError` are all re-exported from `predikit/__init__.py`. Everything else is internal.
-- **Optional imports** — heavy optional deps (`langchain`, `xgboost`, `mlflow`, `snowflake`) are imported inside functions/methods, never at module level, so missing extras don't break core imports.
-- **Feature name matching** — inputs map to model features by column name (using `feature_names_in_` from sklearn), not by position. Mismatches raise a `ValueError` with a clear diff.
-- **Bool coercion** — `coerce_value()` converts LLM strings (`"yes"`, `"true"`, `"1"`, `"on"`) to Python bools before Pydantic validation.
-- **Async** — `ainvoke()` is a thin wrapper over `invoke()` via `loop.run_in_executor`. No async-native I/O involved.
-- **Ensemble strategies** — `"collect"`, `"mean"`, `"vote"`, `"weighted_mean"`, `"weighted_vote"`. Weighted strategies take a `weights` list parallel to `tools`.
-
-## Release process
-
-1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
-2. Add a section to `CHANGELOG.md`.
-3. Commit, push to `main`, create a GitHub Release with the version tag (e.g. `v0.4.1`).
-4. `publish.yml` auto-triggers a PyPI upload via OIDC trusted publishing.
+# predikit — Claude Code context
+
+## What this is
+
+predikit wraps fitted scikit-learn / XGBoost models as LLM-callable tools with auto-generated JSON schemas, typed I/O via Pydantic, and first-class support for OpenAI function calling and LangChain.
+
+## Project layout
+
+```
+src/predikit/          Core package (installed as `predikit`)
+  tool.py              ModelTool — main public class
+  registry.py          ToolRegistry — groups multiple tools for bulk export
+  ensemble.py          ModelEnsemble — multi-model reconciliation strategies
+  exceptions.py        LowConfidenceError
+  coerce.py            LLM-string → Python type coercion (bool, int, float, str)
+  introspect.py        Extract sklearn model metadata (feature names, task type)
+  cli.py               `predikit inspect` CLI (click + joblib)
+  exporters/
+    openai.py          .to_openai() — OpenAI function-calling schema
+    langchain.py       .to_langchain() — LangChain StructuredTool
+  loaders/
+    mlflow.py          from_mlflow() — load from MLflow Model Registry
+    snowflake.py       from_snowflake() — load from Snowflake Model Registry
+tests/                 pytest suite (mirrors src/ layout)
+examples/              Standalone usage scripts (01–07)
+```
+
+## Commands
+
+```bash
+# Install for development
+pip install -e ".[dev]"
+
+# Run tests
+pytest --cov=src/predikit --cov-report=term-missing
+
+# Lint (check only)
+ruff check src/ tests/ examples/
+
+# Format (check only)
+ruff format --check src/ tests/ examples/
+
+# Lint + format (auto-fix)
+ruff check --fix src/ tests/ examples/
+ruff format src/ tests/ examples/
+
+# Type check
+mypy src/predikit
+
+# All checks via pre-commit
+pre-commit run --all-files
+
+# Install pre-commit hooks
+pre-commit install
+```
+
+## Key conventions
+
+- **Public API** — `ModelTool`, `ToolRegistry`, `ModelEnsemble`, `LowConfidenceError` are all re-exported from `predikit/__init__.py`. Everything else is internal.
+- **Optional imports** — heavy optional deps (`langchain`, `xgboost`, `mlflow`, `snowflake`) are imported inside functions/methods, never at module level, so missing extras don't break core imports.
+- **Feature name matching** — inputs map to model features by column name (using `feature_names_in_` from sklearn), not by position. Mismatches raise a `ValueError` with a clear diff.
+- **Bool coercion** — `coerce_value()` converts LLM strings (`"yes"`, `"true"`, `"1"`, `"on"`) to Python bools before Pydantic validation.
+- **Async** — `ainvoke()` is a thin wrapper over `invoke()` via `loop.run_in_executor`. No async-native I/O involved.
+- **Ensemble strategies** — `"collect"`, `"mean"`, `"vote"`, `"weighted_mean"`, `"weighted_vote"`. Weighted strategies take a `weights` list parallel to `tools`.
+
+## Release process
+
+1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
+2. Add a section to `CHANGELOG.md`.
+3. Commit, push to `main`, create a GitHub Release with the version tag (e.g. `v0.4.1`).
+4. `publish.yml` auto-triggers a PyPI upload via OIDC trusted publishing.

{predikit-0.6.1 → predikit-0.6.3}/CONTRIBUTING.md

@@ -1,66 +1,66 @@
-# Contributing to predikit
-
-Thanks for your interest in contributing.
-
-## Prerequisites
-
-- Python 3.10+
-- [pre-commit](https://pre-commit.com/) (`pip install pre-commit`)
-
-## Development setup
-
-```bash
-git clone https://github.com/Tejas-TA/predikit
-cd predikit
-pip install -e ".[dev]"
-pre-commit install
-```
-
-`pre-commit install` wires up ruff and mypy to run automatically before every commit.
-
-## Running tests
-
-```bash
-pytest --cov=src/predikit --cov-report=term-missing
-```
-
-## Code style
-
-This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and [mypy](https://mypy.readthedocs.io/) for type checking. All three are configured in `pyproject.toml`.
-
-```bash
-# Check and auto-fix
-ruff check --fix src/ tests/
-ruff format src/ tests/
-
-# Type check
-mypy src/predikit
-```
-
-Or run everything at once via pre-commit:
-
-```bash
-pre-commit run --all-files
-```
-
-CI enforces all three checks on every push and PR (see `.github/workflows/test.yml`).
-
-## Pull request guidelines
-
-- Target `main`.
-- Keep changes focused — one feature or fix per PR.
-- Add or update tests for any changed behaviour.
-- Run `pre-commit run --all-files` before pushing; CI will catch failures regardless.
-
-## Adding a new exporter or loader
-
-- Exporters live in `src/predikit/exporters/` and should expose a single function consumed by `ModelTool`.
-- Loaders live in `src/predikit/loaders/` and should return a `ModelTool` instance.
-- Any new optional dependency must be added to both the relevant optional group and `dev` in `pyproject.toml`, and imported inside the function body (not at module level).
-
-## Release process (maintainers)
-
-1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
-2. Add a section to `CHANGELOG.md`.
-3. Merge to `main`, create a GitHub Release tagged `vX.Y.Z`.
-4. `publish.yml` automatically publishes to PyPI via OIDC trusted publishing.
+# Contributing to predikit
+
+Thanks for your interest in contributing.
+
+## Prerequisites
+
+- Python 3.10+
+- [pre-commit](https://pre-commit.com/) (`pip install pre-commit`)
+
+## Development setup
+
+```bash
+git clone https://github.com/Tejas-TA/predikit
+cd predikit
+pip install -e ".[dev]"
+pre-commit install
+```
+
+`pre-commit install` wires up ruff and mypy to run automatically before every commit.
+
+## Running tests
+
+```bash
+pytest --cov=src/predikit --cov-report=term-missing
+```
+
+## Code style
+
+This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and [mypy](https://mypy.readthedocs.io/) for type checking. All three are configured in `pyproject.toml`.
+
+```bash
+# Check and auto-fix
+ruff check --fix src/ tests/ examples/
+ruff format src/ tests/ examples/
+
+# Type check
+mypy src/predikit
+```
+
+Or run everything at once via pre-commit:
+
+```bash
+pre-commit run --all-files
+```
+
+CI enforces all three checks on every push and PR (see `.github/workflows/test.yml`).
+
+## Pull request guidelines
+
+- Target `main`.
+- Keep changes focused — one feature or fix per PR.
+- Add or update tests for any changed behaviour.
+- Run `pre-commit run --all-files` before pushing; CI will catch failures regardless.
+
+## Adding a new exporter or loader
+
+- Exporters live in `src/predikit/exporters/` and should expose a single function consumed by `ModelTool`.
+- Loaders live in `src/predikit/loaders/` and should return a `ModelTool` instance.
+- Any new optional dependency must be added to both the relevant optional group and `dev` in `pyproject.toml`, and imported inside the function body (not at module level).
+
+## Release process (maintainers)
+
+1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
+2. Add a section to `CHANGELOG.md`.
+3. Merge to `main`, create a GitHub Release tagged `vX.Y.Z`.
+4. `publish.yml` automatically publishes to PyPI via OIDC trusted publishing.