pinecone

# 🌲 Pinecone

Pinecone vector database — manage indexes, upsert vectors, query similarity search, manage namespaces, and track collections via the Pinecone API.

## Features

- **Index management** — create, configure, delete indexes
- **Vector upsert** — insert and update vectors with metadata
- **Similarity search** — query nearest neighbors
- **Namespace management** — organize vectors by namespace
- **Metadata filtering** — filter queries by metadata fields
- **Collection management** — create snapshots of indexes
- **Batch operations** — bulk upsert and delete
- **Index stats** — vector counts, dimensions, usage
- **Sparse-dense** — hybrid search with sparse vectors
- **Serverless** — auto-scaling serverless indexes

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `PINECONE_API_KEY` | ✅ | API key/token for Pinecone |

## Quick Start

```bash
# List indexes
python3 {baseDir}/scripts/pinecone.py indexes
```

```bash
# Get index details
python3 {baseDir}/scripts/pinecone.py index-get my-index
```

```bash
# Create an index
python3 {baseDir}/scripts/pinecone.py index-create '{"name":"my-index","dimension":1536,"metric":"cosine","spec":{"serverless":{"cloud":"aws","region":"us-east-1"}}}'
```

```bash
# Delete an index
python3 {baseDir}/scripts/pinecone.py index-delete my-index
```



## Commands

### `indexes`
List indexes.
```bash
python3 {baseDir}/scripts/pinecone.py indexes
```

### `index-get`
Get index details.
```bash
python3 {baseDir}/scripts/pinecone.py index-get my-index
```

### `index-create`
Create an index.
```bash
python3 {baseDir}/scripts/pinecone.py index-create '{"name":"my-index","dimension":1536,"metric":"cosine","spec":{"serverless":{"cloud":"aws","region":"us-east-1"}}}'
```

### `index-delete`
Delete an index.
```bash
python3 {baseDir}/scripts/pinecone.py index-delete my-index
```

### `upsert`
Upsert vectors.
```bash
python3 {baseDir}/scripts/pinecone.py upsert --index my-index '{"vectors":[{"i...