# pinecone-ts-client

> The official TypeScript/Node client for the Pinecone vector database

- **URL**: https://www.freshcrate.ai/projects/pinecone-ts-client
- **Author**: pinecone-io
- **Category**: Databases
- **Latest version**: `v7.2.0` (2026-04-10)
- **License**: Apache-2.0
- **Source**: https://github.com/pinecone-io/pinecone-ts-client
- **Homepage**: https://www.pinecone.io
- **Language**: TypeScript
- **GitHub**: 269 stars, 46 forks
- **Registry**: github
- **Tags**: `llm`, `pinecone`, `semantic-search`, `similarity-search`, `typescript`, `vector-database`

## Description

The official TypeScript/Node client for the Pinecone vector database

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v7.2.0` | 2026-04-10 | High | ### Streaming file uploads for Assistant  `uploadFile` now accepts a `Buffer`, `Blob`, or Node.js `ReadableStream` directly, in addition to the existing local file path. This makes it possible to forward an incoming HTTP upload to the Assistant without writing the file to disk or buffering it in memory first.  ```typescript // Existing path-based usage — unchanged await assistant.uploadFile({ path: 'report.pdf' });  // New: upload from a Buffer (e.g. multer memory storage) await assista |
| `v7.1.0` | 2026-02-19 | Low | This release adds support for creating and configuring index `readCapacity` for BYOC indexes.  ```typescript // Create a BYOC index with dedicated read capacity await pinecone.createIndex({   name: 'my-byoc-index',   dimension: 1536,   metric: 'cosine',   spec: {     byoc: {       environment: 'aws-us-east-1-b921',       readCapacity: {         mode: 'Dedicated',         nodeType: 'b1',         manual: { replicas: 1, shards: 1 },       },     },   }, }); ```  It also include |
| `v7.0.0` | 2026-02-01 | Low | # Release v7.0.0  This version of the Pinecone Node SDK depends on version `2025-10` of the Pinecone API. You can read more about versioning [here](https://docs.pinecone.io/reference/api/introduction#versioning). This v7 SDK release line should continue to receive fixes as long as the `2025-10` API version is in support.  ## Breaking Changes  ### Index Targeting  The preferred way to target an index has changed. You must now pass an options object to `pc.index()` instead of string argume |
| `v6.1.4` | 2026-01-22 | Low | ## What's changed  This patch release adds an optional configuration that can allow AI coding agents working with the SDK to identify themselves. This information is incorporated into request User-Agent headers to help us track how our product is being used.  ```typescript const pc = new Pinecone({    apiKey: 'your-api-key',    caller: {      provider: 'google',      model: 'gemini'    } }); ```  **Full Changelog**: https://github.com/pinecone-io/pinecone-ts-client/compare/v6.1.3.. |
| `v6.1.3` | 2025-11-03 | Low | This release fixes a bug in `Assistant.listFiles()` when using a `filter` - there's no need to provide a top-level `metadata` key inside of the filter object.  ## What's Changed * Handle errors in `cleanupResources` by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/351 * Add `tsx` as a `devDependency`, clean up `setup` GH action by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/352 * Fix list files with filter in Assistant by @avi1mizrah |
| `v6.1.2` | 2025-07-22 | Low | `Assistant.describeFile` now exposes `includeUrl` as an optional argument, and it will default to `true` if not provided. `sourceCollection` is also now exposed on `CreateIndexServerlessSpec` and `IndexModel`.  ## What's Changed * Expose `includeUrl` in `Assistant.describeFile`, add `sourceCollection` for serverless by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/349   **Full Changelog**: https://github.com/pinecone-io/pinecone-ts-client/compare/v6.1.1...v6.1.2 |
| `v6.1.1` | 2025-06-14 | Low | ## What's Changed * Regenerate core, expose `privateHost` on `IndexModel`, and `temperature` on `ChatOptions` and `ChatCompletionOptions` by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/348   **Full Changelog**: https://github.com/pinecone-io/pinecone-ts-client/compare/v6.1.0...v6.1.1 |
| `v6.1.0` | 2025-06-01 | Low | This release adds a new `ChatContextOptions` type which allows passing `contextOptions` in `ChatOptions` when calling `chat` or `chatStream`. `ChatContextOptions` supports passing `topK` and `snippetSize`. There have also been fixes made to `context` and `chat` methods to fix issues with argument parameters not being properly passed with the requests.  ## What's Changed * Add `ChatContextOptions` to `ChatOptions` by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/347 |
| `v6.0.1` | 2025-05-20 | Low | This patch fixes an issue with the `listBackups` method not applying pagination to project-level operations. There have also been additional types exported from the top of the package for working with backups and inference models.  ## What's Changed * Regenerate `2025-04`, add pagination to list project backups by @austin-denoble in https://github.com/pinecone-io/pinecone-ts-client/pull/346   **Full Changelog**: https://github.com/pinecone-io/pinecone-ts-client/compare/v6.0.0...v6.0.1 |
| `v6.0.0` | 2025-05-10 | Low | This version of the Pinecone Node SDK depends on version `2025-04` of the Pinecone API. You can read more about versioning [here](https://docs.pinecone.io/reference/api/versioning). This v6 SDK release line should continue to receive fixes as long as the `2025-04` API version is in support.  ## Features  ### Namespaces  You now have the ability to work more explicitly with namespaces that are associated with an index. There have been several namespace methods added to the `Index` class: |

## Citation

- HTML: https://www.freshcrate.ai/projects/pinecone-ts-client
- Markdown: https://www.freshcrate.ai/projects/pinecone-ts-client.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/pinecone-ts-client/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._