docs(quick-tour): bump to pinecone 9.1.0#599
Merged
Merged
Conversation
hello-pinecone, interacting-with-the-index, namespacing, simple-classifier. Consolidate imports into the first (pip) cell and single-line the installs to satisfy check-structure / check-pinning; normalized via the repo pre-commit pipeline (ruff + nbstripout). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The inline rag-getting-started link used /blob/master (default branch is main), which 302-redirects and fails check-links. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This was referenced Jul 8, 2026
jennapederson
approved these changes
Jul 9, 2026
jennapederson
left a comment
jennapederson
left a comment
Contributor
There was a problem hiding this comment.
I have no idea what these are or where they are linked from. Added source tags to see if they are used.
joerg84
added a commit
that referenced
this pull request
Jul 9, 2026
## Why
Continues the `docs/` migration off the pre-9.x client (no default
data-plane timeout). Was `pinecone~=8.0`.
## Changes
- Pin → `pinecone==9.1.0`.
- 9.x search-hit fix: `hit["_id"]`/`hit["_score"]` →
`hit["id"]`/`hit["score"]` (double-quoted reads in the dedupe/transform
helpers). The dedupe output dict already uses an `"id"` key and the
reranker path is untouched.
- Normalized via the repo pre-commit pipeline (ruff + nbstripout).
Already uses dict `query={...}` and `pc.inference.rerank(...)`, so no
Search* object issues.
## Verification
All six lint gates pass locally; live `test-notebooks` validates the
runtime on this PR.
Follows #598, #599, #600.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> **Low Risk**
> Documentation-only notebook changes with a small API field rename; no
production code paths.
>
> **Overview**
> Updates **`docs/gen-qa-openai.ipynb`** for **Pinecone 9.x**: the
install pin moves from `pinecone~=8.0` to **`pinecone==9.1.0`**.
>
> **Cascading retrieval** dedupe logic now keys search hits with
**`hit["id"]`** instead of **`hit["_id"]`**, matching the 9.x search
response shape so merge/rerank still works.
>
> The notebook was **cleaned for publication** (outputs cleared,
`execution_count` reset, sources reformatted) via the repo pre-commit
tooling.
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
437b32b. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
Co-authored-by: joerg84 <joerg@pinecone.io>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
joerg84
added a commit
that referenced
this pull request
Jul 9, 2026
## Why Continues the `docs/` migration off the pre-9.x client. Was `pinecone~=8.0`. ## Changes - Pin → `pinecone==9.1.0`. - **9.x search-hit fix, surgical.** Only the reads off actual search `Hit` objects are renamed to `["id"]`/`["score"]`: `print_hits`, the dedupe key `hit["_id"]`, and the sort key `x["_score"]`. The `merge_chunks` output dicts deliberately **keep** their `"_id"`/`"_score"` keys, so the downstream `row["_id"]`/`row["_score"]` reads and the `pc.inference.rerank(documents=...)` input are unchanged (a blanket rename would have broken those). - Normalized via ruff + nbstripout. ## Verification All six lint gates pass locally; live `test-notebooks` validates the runtime. Follows #598, #599, #600, #601. This completes the cleanly-bumpable `docs/` set; the remainder is dependency-blocked (langchain-pinecone `<8`, pinecone-datasets `<4`) or requires v3-API rewrites (`pinecone==0.2.13`). 🤖 Generated with [Claude Code](https://claude.com/claude-code) <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Documentation-only notebook changes with no production code or security impact; behavioral risk is limited to example correctness under the new client. > > **Overview** > Updates **`docs/cascading-retrieval.ipynb`** for **Pinecone 9.1.0** (from `pinecone~=8.0`), including a pinned install and early `Pinecone` import in the setup cell. > > **9.x search hit shape:** `print_hits` and `merge_chunks` now read **`id`** and **`score`** on API hits (replacing `_id` / `_score`). `merge_chunks` still emits **`_id`** / **`_score`** on its output dicts so merge printing and `pc.inference.rerank(documents=...)` stay unchanged. > > Notebook outputs were cleared (`execution_count: null`, empty `outputs`) via **ruff** and **nbstripout**. > > <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit cefdaf7. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).</sup> <!-- /CURSOR_SUMMARY --> Co-authored-by: joerg84 <joerg@pinecone.io> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
joerg84
added a commit
that referenced
this pull request
Jul 9, 2026
) ## Why Continues moving `docs/` off the pre-9.x client (urllib3, no default data-plane timeout). 9.x (httpx) applies a 30s default with retries. Both notebooks were `pinecone==8.0.0`. ## Changes - Pin bump → `pinecone==9.1.0`; pin `pinecone-notebooks==0.1.1` (was unpinned in pinecone-quickstart). - **9.x search-hit fix:** `hit['_id']`/`hit['_score']` → `hit['id']`/`hit['score']` (and `result['_score']`). 9.x renames the `Hit` wire fields; only the bracket **reads** change — the 50 `"_id":` **upsert record keys** in pinecone-quickstart are left as-is (the records API still expects `_id`). - Consolidate imports into the first (pip) cell (`check-structure`), normalized via the repo pre-commit pipeline (`ruff` + `nbstripout`). `SearchQuery`/`SearchRerank`/`Pinecone` and the integrated `search`/`upsert_records` surface verified present on 9.1.0. ## Verification All six lint gates pass locally; live `test-notebooks` validates the runtime on this PR — please confirm green before merge. ## Context Follows #598 (lexical-search) and #599 (quick-tour). The `_id`/`_score` break is systemic across integrated-search notebooks; `gen-qa-openai` and `cascading-retrieval` get the same fix in follow-ups (handled individually — heavier logic). 🤖 Generated with [Claude Code](https://claude.com/claude-code) <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Documentation-only notebook updates with no production code, auth, or data-path changes; runtime behavior depends on CI notebook tests passing on 9.1.0. > > **Overview** > Updates **`docs/pinecone-quickstart.ipynb`** and **`docs/semantic-search.ipynb`** from `pinecone==8.0.0` to **`pinecone==9.1.0`**, pins **`pinecone-notebooks==0.1.1`**, and aligns both notebooks with the 9.x integrated-search client API. > > **SDK usage:** Search calls drop `SearchQuery` / `SearchRerank` in favor of plain **`query`** and **`rerank`** dicts. Search hit handling switches from **`hit['_id']` / `hit['_score']`** to **`hit['id']` / `hit['score']`** (upsert records still use `"_id"`). The quickstart moves **`os`**, **`time`**, and **`Pinecone`** into the install cell, adds a **`source_tag`** on `Pinecone(...)`, and merges the duplicate pip cell in semantic-search. > > **Notebook hygiene:** Cleared stored outputs and reset **`execution_count`** to null (nbstripout-style), plus minor Unicode fixes in sample strings. > > <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit e29f29c. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).</sup> <!-- /CURSOR_SUMMARY --> --------- Co-authored-by: joerg84 <joerg@pinecone.io> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com> Co-authored-by: Jenna Pederson <jenna@pinecone.io>
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
2 participants
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.
Why
Part of moving the
docs/notebooks off the pre-9.x client (urllib3, no default data-plane timeout — the root cause behind the notebook-checker hangs). 9.x (httpx) applies a 30s default with retries.Covers the four quick-tour notebooks:
hello-pinecone,interacting-with-the-index,namespacing,simple-classifier(all werepinecone==8.0.0).Changes (per notebook)
pinecone==8.0.0→9.1.0.check-structure(imports only in the first code cell), and runtime-safe because the harness runs cells top-to-bottom with no pre-install, so imports must follow the!pip install.!pip install—check-pinningreads a\continuation as an unpinned package.ruff --fix,ruff-format,nbstripout), which is what accounts for most of the diff size (stale 8.x outputs stripped, import blocks sorted). The semantic change is just the three bullets above.No
_id/_scoreresult access in these notebooks, so no API-shape fixes were needed. API surface used (Pinecone,ServerlessSpec,CloudProvider,AwsRegion,Metric,has_index,create_index,Index(host=),upsert,query,describe_index_stats,delete_index) verified present on 9.1.0.Verification
test-notebooksruntime validation runs on this PR against a real cluster — please confirm green before merge.Context
Follows #598 (lexical-search). Companion timeout fix:
pinecone-notebook-checker#29. The remainingdocs/notebooks (_id/_scoreset,pinecone-datasets-blocked, and the two ancient0.2.13rewrites) are separate follow-ups.🤖 Generated with Claude Code
Note
Low Risk
Documentation-only notebook edits with dependency pin and formatting; no application or production code paths.
Overview
Updates the four docs/quick-tour notebooks (
hello-pinecone,interacting-with-the-index,namespacing,simple-classifier) frompinecone==8.0.0topinecone==9.1.0so they run on the 9.x client (httpx default timeouts instead of 8.x urllib3 hangs).Each notebook now uses a single-line
!pip installwith pinned deps, moves all imports into the first code cell right after install (notebook CI structure rules), and constructsPinecone(..., source_tag=...)per example. Stale executed outputs are cleared and cell metadata normalized via the repo formatter;hello-pineconealso fixes the RAG link branch frommastertomain.No query/upsert API call changes beyond the client version and import layout—the tutorials behave the same.
Reviewed by Cursor Bugbot for commit 215ff58. Bugbot is set up for automated code reviews on this repo. Configure here.