pineconego

README

Unofficial Pinecone Go SDK

This is Pinecone's unofficial Go client, designed to enable you to use Pinecone's services easily from your own applications.

Pinecone

Pinecone is a managed, cloud-native vector database that allows you to build high-performance vector search applications.

API support v2

Index Operations	Status	Vector Operations	Status
List Collections	🟢	DescribeIndexStats	🟢
Create Collection	🟢	Query	🟢
Describe Collection	🟢	Delete	🟢
Delete Collection	🟢	Fetch	🟢
List Indexes	🟢	Update	🟢
Create Index	🟢	Upsert	🟢
Describe Index	🟢	List	🟢
Delete Index	🟢
Configure Index	🟢

Getting started

Installation

You can load pinecone-go into your project by using:

go get github.com/henomis/pinecone-go/v2@v2.0.0

Configuration

The only thing you need to start using Pinecone's APIs is the developer API key and related environment. Copy and paste them in the corresponding place in the code, select the API and the parameters you want to use, and that's it.

Usage

Please refer to the examples folder to see how to use the SDK.

Here below a simple usage example:

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"os"

	pineconego "github.com/henomis/pinecone-go/v2"
	"github.com/henomis/pinecone-go/v2/request"
	"github.com/henomis/pinecone-go/v2/response"
)

func main() {
	apiKey := os.Getenv("PINECONE_API_KEY")
	if apiKey == "" {
		panic("PINECONE_API_KEY is not set")
	}

	p := pineconego.New(apiKey)
	replicas := 1
	shards := 1
	metric := request.MetricCosine
	req := &request.IndexCreate{
		Name:      "test-index",
		Dimension: 10,
		Metric:    &metric,
		Spec: request.Spec{
			Pod: &request.PodSpec{
				Replicas:    &replicas,
				Shards:      &shards,
				PodType:     "s1.x1",
				Environment: "gcp-starter",
			},
		},
	}
	res := &response.IndexCreate{}
	err := p.IndexCreate(context.Background(), req, res)
	if err != nil {
		panic(err)
	}

	if !res.IsSuccess() {
		if res.Response.Code != nil {
			fmt.Printf("Error: %d -", *res.Response.Code)
		}

		if res.Response.Message != nil {
			fmt.Printf(" %s\n", *res.Response.Message)
		}

		if res.Response.RawBody != nil {
			fmt.Printf(" %s\n", *res.Response.RawBody)
		}

		return
	}

	b, err := json.MarshalIndent(res, "", "  ")
	if err != nil {
		panic(err)
	}

	fmt.Println(string(b))

}

Who uses pinecone-go?

• LinGoose Go framework for building awesome LLM apps

Documentation

Index

• type PineconeGo
  • func New(apiKey string) *PineconeGo
  • func (p *PineconeGo) IndexConfigure(ctx context.Context, req *request.IndexConfigure, res *response.IndexConfigure) error
  • func (p *PineconeGo) IndexCreate(ctx context.Context, req *request.IndexCreate, res *response.IndexCreate) error
  • func (p *PineconeGo) IndexCreateCollection(ctx context.Context, req *request.IndexCreateCollection, ...) error
  • func (p *PineconeGo) IndexDelete(ctx context.Context, req *request.IndexDelete, res *response.IndexDelete) error
  • func (p *PineconeGo) IndexDeleteCollection(ctx context.Context, req *request.IndexDeleteCollection, ...) error
  • func (p *PineconeGo) IndexDescribe(ctx context.Context, req *request.IndexDescribe, res *response.IndexDescribe) error
  • func (p *PineconeGo) IndexDescribeCollection(ctx context.Context, req *request.IndexDescribeCollection, ...) error
  • func (p *PineconeGo) IndexList(ctx context.Context, req *request.IndexList, res *response.IndexList) error
  • func (p *PineconeGo) IndexListCollections(ctx context.Context, req *request.IndexListCollections, ...) error
  • func (p *PineconeGo) VectorDelete(ctx context.Context, req *request.VectorDelete, res *response.VectorDelete) error
  • func (p *PineconeGo) VectorDescribeIndexStats(ctx context.Context, req *request.VectorDescribeIndexStats, ...) error
  • func (p *PineconeGo) VectorFetch(ctx context.Context, req *request.VectorFetch, res *response.VectorFetch) error
  • func (p *PineconeGo) VectorList(ctx context.Context, req *request.VectorList, res *response.VectorList) error
  • func (p *PineconeGo) VectorQuery(ctx context.Context, req *request.VectorQuery, res *response.VectorQuery) error
  • func (p *PineconeGo) VectorUpdate(ctx context.Context, req *request.VectorUpdate, res *response.VectorUpdate) error
  • func (p *PineconeGo) VectorUpsert(ctx context.Context, req *request.VectorUpsert, res *response.VectorUpsert) error

Types

type PineconeGo

type PineconeGo struct {
	// contains filtered or unexported fields
}

func New

func New(apiKey string) *PineconeGo

func (*PineconeGo) IndexConfigure

func (p *PineconeGo) IndexConfigure(
	ctx context.Context,
	req *request.IndexConfigure,
	res *response.IndexConfigure,
) error

func (*PineconeGo) IndexCreate

func (p *PineconeGo) IndexCreate(
	ctx context.Context,
	req *request.IndexCreate,
	res *response.IndexCreate,
) error

func (*PineconeGo) IndexCreateCollection

func (p *PineconeGo) IndexCreateCollection(
	ctx context.Context,
	req *request.IndexCreateCollection,
	res *response.IndexCreateCollection,
) error

func (*PineconeGo) IndexDelete

func (p *PineconeGo) IndexDelete(
	ctx context.Context,
	req *request.IndexDelete,
	res *response.IndexDelete,
) error

func (*PineconeGo) IndexDeleteCollection

func (p *PineconeGo) IndexDeleteCollection(
	ctx context.Context,
	req *request.IndexDeleteCollection,
	res *response.IndexDeleteCollection,
) error

func (*PineconeGo) IndexDescribe

func (p *PineconeGo) IndexDescribe(
	ctx context.Context,
	req *request.IndexDescribe,
	res *response.IndexDescribe,
) error

func (*PineconeGo) IndexDescribeCollection

func (p *PineconeGo) IndexDescribeCollection(
	ctx context.Context,
	req *request.IndexDescribeCollection,
	res *response.IndexDescribeCollection,
) error

func (*PineconeGo) IndexList

func (p *PineconeGo) IndexList(
	ctx context.Context,
	req *request.IndexList,
	res *response.IndexList,
) error

func (*PineconeGo) IndexListCollections

func (p *PineconeGo) IndexListCollections(
	ctx context.Context,
	req *request.IndexListCollections,
	res *response.IndexListCollections,
) error

func (*PineconeGo) VectorDelete

func (p *PineconeGo) VectorDelete(
	ctx context.Context,
	req *request.VectorDelete,
	res *response.VectorDelete,
) error

func (*PineconeGo) VectorDescribeIndexStats

func (p *PineconeGo) VectorDescribeIndexStats(
	ctx context.Context,
	req *request.VectorDescribeIndexStats,
	res *response.VectorDescribeIndexStats,

) error

func (*PineconeGo) VectorFetch

func (p *PineconeGo) VectorFetch(
	ctx context.Context,
	req *request.VectorFetch,
	res *response.VectorFetch,
) error

func (*PineconeGo) VectorList

func (p *PineconeGo) VectorList(
	ctx context.Context,
	req *request.VectorList,
	res *response.VectorList,
) error

func (*PineconeGo) VectorQuery

func (p *PineconeGo) VectorQuery(
	ctx context.Context,
	req *request.VectorQuery,
	res *response.VectorQuery,
) error

func (*PineconeGo) VectorUpdate

func (p *PineconeGo) VectorUpdate(
	ctx context.Context,
	req *request.VectorUpdate,
	res *response.VectorUpdate,
) error

func (*PineconeGo) VectorUpsert

func (p *PineconeGo) VectorUpsert(ctx context.Context, req *request.VectorUpsert, res *response.VectorUpsert) error