Repository navigation
Lean PyPI install: pip install graphier + graphier setup, trusted publishing - #14
Merged
Merged
Conversation
'pip install graphier' previously declared semantica as a hard dependency — whose own dependency list pulls torch/transformers/spacy (multi-gigabyte) that Graphier's deterministic path never imports. - dependencies are now the lean set Graphier actually uses (fastapi, uvicorn, pypdf, python-multipart, numpy, pandas, scipy, networkx); semantica moves to the optional [ml] extra. - New graphier.cli entry points: 'graphier setup' installs the engine package alone (pip install --no-deps semantica); launching without it prints the one command to run instead of a traceback. graphier-mcp gets the same guard. - Release workflow gains a publish-pypi job using PyPI trusted publishing (OIDC, no token) — gated on the PYPI_PUBLISH repo variable and documented step-by-step in docs/launch-checklist.md. - README gains the pip quick start; CHANGELOG updated. - 4 new tests (55 total). Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QVbxD1gd3gsC6zXKE6L3ya
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follows the merged #13. Makes
pip install graphiera real, lean distribution channel — and removes a launch-day trap.The trap
graphierdeclaredsemanticaas a hard dependency, and semantica's own dependency list pulls torch + transformers + spacy (multi-gigabyte) — none of which Graphier's deterministic path ever imports. A first-timepip install graphierdownloading gigabytes of ML frameworks would have been the top complaint in every launch thread.The fix
graphiernow depends only on what it actually uses (fastapi, uvicorn, pypdf, python-multipart, numpy, pandas, scipy, networkx). Full Semantica moves to the optionalgraphier[ml]extra.graphier setup: new CLI entry point installs the engine package alone (pip install --no-deps semantica— quick, no ML downloads). Launching without the engine prints the one command to run instead of a traceback;graphier-mcpgets the same guard.publish-pypijob using OIDC (pypa/gh-action-pypi-publish) — no token or secret to manage. Gated on thePYPI_PUBLISHrepo variable; the one-time pypi.org setup (pending publisher for this repo, workflowrelease.yml, environmentpypi) is documented step-by-step indocs/launch-checklist.md.Why PyPI and not npm: Graphier's runtime is Python — the frontend is already built and bundled inside the wheel by the release workflow, so a single pip install ships the whole app. npm would only make sense for a JS-native runtime, which this isn't.
Testing
4 new tests (55 total): engine detection, the missing-engine message + exit code,
setupinvoking the lean pip command, and the MCP guard. Entry points verified end-to-end locally:graphier setupran the engine install and both console scripts resolve.🤖 Generated with Claude Code
https://claude.ai/code/session_01QVbxD1gd3gsC6zXKE6L3ya
Generated by Claude Code