Skip to content

Commit 0c184db

Browse files
committed
Polish packaging extras and install docs
1 parent 316e2e1 commit 0c184db

7 files changed

Lines changed: 52 additions & 23 deletions

File tree

‎.github/workflows/ci.yml‎

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,9 @@ jobs:
3535
- name: Install
3636
run: |
3737
if [ "${{ matrix.python-version }}" = "3.13" ]; then
38-
# tokenizers 0.19 (pulled by ml/litellm) has no cp313 wheels yet — skip those extras.
39-
uv sync --extra dev --extra scrape --extra yara --extra haystack --extra presidio --group dev
38+
# Skip ml/litellm on the 3.13 test matrix (heavy); wheel-only resolve
39+
# for [ml] is covered by the packaging-ml-wheels job below.
40+
uv sync --extra scrape --extra yara --extra haystack --extra presidio --dev
4041
else
4142
uv sync --all-extras --dev
4243
fi
@@ -72,3 +73,25 @@ jobs:
7273
xml-skip-covered: true
7374
report-only-changed-files: true
7475
default-branch: dev
76+
77+
# Catch sdist-only transitive breakage that plain lock/compile misses
78+
# (e.g. tokenizers without a cp313 wheel). Dry-run — no torch download.
79+
packaging-ml-wheels:
80+
runs-on: ubuntu-latest
81+
defaults:
82+
run:
83+
working-directory: sdk
84+
steps:
85+
- uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
86+
87+
- uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
88+
with:
89+
enable-cache: true
90+
version: "0.6.14"
91+
92+
- uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
93+
with:
94+
python-version: "3.13"
95+
96+
- name: Resolve unplug-ai[ml] wheels-only
97+
run: uv pip compile --python-version 3.13 --extra ml --no-build -o /tmp/ml-wheels.txt pyproject.toml

‎CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,14 @@ All notable changes to the `unplug-ai` SDK.
77
### Added
88

99
- Offline synthetic BIOES checkpoint fixture for ML unit tests (no real weights required)
10+
- CI wheel-only resolve for `unplug-ai[ml]` on Python 3.13 (catches sdist-only breakage)
1011

1112
### Changed
1213

1314
- Unknown `active_model` tier names now raise `ConfigError` with valid catalog tiers instead of silently running without ML
15+
- Widen `transformers` extra constraint to `>=4.44,<6` (was `<5.13`) so newer minors stay installable
16+
- Drop published `dev` optional-extra; test/lint tools live in the `dev` dependency-group (`uv sync --dev`)
17+
- Docs: `unplug-ai[scrape]` package name in Firecrawl docstring; Atomic Agents Python ≥3.12 install gate; Semantic Kernel `pybars4` wheel-only note
1418

1519
### Fixed
1620

‎sdk/integrations/atomic-agents/README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,9 @@ Pydantic-schema-driven framework: `AtomicAgent[InputSchema, OutputSchema]` with
1212
- **Output** — scan the output schema's text field after `agent.run`.
1313
- **Tools** — gate a `BaseTool` call before it executes.
1414

15-
> Atomic Agents 2.x requires Python ≥3.12, so this extra is a no-op on 3.11.
15+
> **Python ≥3.12 required.** The `atomic-agents` extra is gated with an environment
16+
> marker, so `pip install "unplug-ai[atomic-agents]"` on Python 3.11 installs nothing
17+
> (the package itself requires ≥3.12).
1618
1719
## Guard agent I/O
1820

‎sdk/integrations/semantic-kernel/README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@
33
**Extra:** `pip install "unplug-ai[semantic-kernel]"`
44
**Module:** `unplug.integrations.semantic_kernel`
55

6+
> **Wheel-only installs:** `semantic-kernel` depends on `pybars4`, which publishes
7+
> sdists only on PyPI. `pip install --only-binary=:all:` / `uv --no-build` of
8+
> `unplug-ai[semantic-kernel]` or `[integrations]` will fail until a wheel exists.
9+
610
## Filters around kernel invoke
711

812
```python

‎sdk/pyproject.toml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ dependencies = [
3030
ml = [
3131
"huggingface_hub>=0.23",
3232
"onnxruntime>=1.17",
33-
"transformers>=4.44,<5.13",
33+
"transformers>=4.44,<6",
3434
"sentencepiece>=0.2",
3535
"numpy>=1.26",
3636
"torch>=2.0",
@@ -116,12 +116,6 @@ integrations = [
116116
# unrelated dependency trees. Live framework coverage runs in the dedicated
117117
# `integrations-live` CI job (see integrations/TESTING.md).
118118
all = ["unplug-ai[ml,scrape,litellm,yara,haystack,presidio]"]
119-
dev = [
120-
"pytest>=8.0",
121-
"pytest-asyncio>=0.23",
122-
"pytest-cov>=7.1.0",
123-
"ruff>=0.4",
124-
]
125119

126120
[project.urls]
127121
Homepage = "https://unplug-ai.org"
@@ -272,6 +266,10 @@ dev = [
272266
"datasets>=4.8.5",
273267
"mypy>=2.1.0",
274268
"pyarrow>=24.0.0",
269+
"pytest>=8.0",
270+
"pytest-asyncio>=0.23",
271+
"pytest-cov>=7.1.0",
275272
"pyyaml>=6.0.3",
273+
"ruff>=0.4",
276274
"types-pyyaml>=6.0.12.20260518",
277275
]

‎sdk/src/unplug/providers/content/firecrawl.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
"""Firecrawl-backed scraper (optional unplug[scrape] extra)."""
1+
"""Firecrawl-backed scraper (optional unplug-ai[scrape] extra)."""
22

33
from __future__ import annotations
44

‎sdk/uv.lock‎

Lines changed: 10 additions & 12 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)