Pinecone.NET
1.2.0
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Pinecone.NET --version 1.2.0
NuGet\Install-Package Pinecone.NET -Version 1.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Pinecone.NET" Version="1.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Pinecone.NET --version 1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Pinecone.NET, 1.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Pinecone.NET as a Cake Addin
#addin nuget:?package=Pinecone.NET&version=1.2.0
// Install Pinecone.NET as a Cake Tool
#tool nuget:?package=Pinecone.NET&version=1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Pinecone.NET
Pinecone.NET is a C# library for the Pinecone vector database. It aims to provide identical functionality to the official Python and Rust libraries.
Features
- Standard Index operations
- gRPC and REST transports for vector operations
- Sparse-dense vectors
- Efficient vector serialization
- Metadata support
- NativeAOT compatibility
Installation
dotnet add package Pinecone.NET or Install-Package Pinecone.NET
Usage
Working with indexes
using Pinecone;
// Initialize the client with your API key and environment
var apiKey = "<your-api-key>";
var environment = "<your-environment>"; // for example us-east4-gcp
using var pinecone = new PineconeClient(apiKey, environment);
// List all indexes
var indexes = await pinecone.ListIndexes();
// Create a new index if it doesn't exist
var indexName = "myIndex";
if (!indexes.Contains(indexName))
{
await pinecone.CreateIndex(indexName, 1536, Metric.Cosine);
}
// Get an index (uses gRPC transport by default)
using var index = await pinecone.GetIndex(indexName);
// Get an index that uses specific transport
using Pinecone.Rest;
...
using var index = await pinecone.GetIndex<RestTransport>(indexName);
// Configure an index
await pinecone.ConfigureIndex(indexName, replicas: 2, podType: "p2");
// Delete an index
await pinecone.DeleteIndex(indexName);
Working with vectors
// Assuming you have an instance of `index`
// Create and upsert vectors
var vectors = new[]
{
new Vector
{
Id = "vector1",
Values = new float[] { 0.1f, 0.2f, 0.3f },
Metadata = new MetadataMap
{
["genre"] = "horror",
["duration"] = 120
}
}
};
await index.Upsert(vectors);
// Fetch vectors by IDs
var fetched = await index.Fetch(new[] { "vector1" });
// Query scored vectors by ID
var scored = await index.Query("vector1", topK: 10);
// Query scored vectors by a new, previously unseen vector
var vector = new[] { 0.1f, 0.2f, 0.3f, ... };
var scored = await index.Query(vector, topK: 10);
// Delete vectors by vector IDs
await index.Delete(new[] { "vector1" });
// Delete vectors by metadata filter
await index.Delete(new MetadataMap
{
["genre"] = new MetadataMap
{
["$in"] = new MetadataValue[] { "documentary", "action" }
}
});
// Delete all vectors in the index
await index.DeleteAll();
Working with Collections
using Pinecone;
// Assuming you have an instance of `PineconeClient` named `pinecone`
// List all collections
var collections = await pinecone.ListCollections();
// Create a new collection
await pinecone.CreateCollection("myCollection", "myIndex");
// Describe a collection
var details = await pinecone.DescribeCollection("myCollection");
// Delete a collection
await pinecone.DeleteCollection("myCollection");
Contributing
Contributions are welcome! Feel free open an issue or a PR.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net7.0
- CommunityToolkit.Diagnostics (>= 8.2.0)
- Google.Protobuf (>= 3.23.0)
- Grpc.Net.Client (>= 2.53.0)
- Grpc.Net.ClientFactory (>= 2.53.0)
- RangeExtensions (>= 2.1.1)
- System.Text.Json (>= 8.0.0-preview.3.23174.8)
-
net8.0
- CommunityToolkit.Diagnostics (>= 8.2.0)
- Google.Protobuf (>= 3.23.0)
- Grpc.Net.Client (>= 2.53.0)
- Grpc.Net.ClientFactory (>= 2.53.0)
- RangeExtensions (>= 2.1.1)
- System.Text.Json (>= 8.0.0-preview.3.23174.8)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Pinecone.NET:
| Package | Downloads |
|---|---|
|
Squidex.AI
Squidex Internal Libraries |
|
|
OBotService
OBase Framework |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Pinecone.NET:
| Repository | Stars |
|---|---|
|
Azure-Samples/azure-search-openai-demo-csharp
A sample app for the Retrieval-Augmented Generation pattern running in Azure, using Azure Cognitive Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences.
|