Skip to content

docs(readme): fix SDK install (not on PyPI — install from source) - #42

Merged
prashar32 merged 1 commit into
mainfrom
docs/readme-sdk-install
May 31, 2026
Merged

docs(readme): fix SDK install (not on PyPI — install from source)#42
prashar32 merged 1 commit into
mainfrom
docs/readme-sdk-install

Conversation

@prashar32

Copy link
Copy Markdown
Owner

Problem (launch-blocker)

The README tells people to pip install riskkernel (twice — the "three ways to adopt" list and the quickstart tail), but riskkernel isn't on PyPI (https://pypi.org/pypi/riskkernel/json → 404). Anyone following the #2 adoption path hits No matching distribution found for riskkernel. The name is unclaimed (404, not squatted), so it's a clean failure — but it's the kind of thing an HN/Reddit visitor trips on in the first 60 seconds.

Fix

Point both spots at the from-source install, which works now that v0.1.1 fixed the wheel packaging (#32):

pip install "git+https://github.com/prashar32/riskkernel.git#subdirectory=sdks/python"

Verified end-to-end in a clean venv: installs riskkernel 0.1.1, import riskkernel resolves Runtime / BudgetExceeded / etc.

PyPI publish stays on the roadmap (the name is free to claim when a publish workflow lands).

Note (separate, not changed here)

The quickstart curl uses model claude-sonnet-4-5 — worth confirming that id still resolves with a current key before launch, or swapping to claude-haiku-4-5-20251001 (what the codebase-qa demo uses). Left as-is; editorial call.

`pip install riskkernel` appeared twice in the README, but the package isn't
published to PyPI (404), so anyone following the Python-SDK adoption path hit
"No matching distribution". Point both spots at the from-source install
(`pip install "git+https://github.com/prashar32/riskkernel.git#subdirectory=sdks/python"`),
which works now that v0.1.1 fixed the wheel packaging (#32). Verified end-to-end:
installs riskkernel 0.1.1 and imports. PyPI publish stays on the roadmap.
@prashar32
prashar32 merged commit f5bf5d1 into main May 31, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant