Metadata-Version: 2.4
Name: oakcylinder
Version: 0.1.1
Summary: Pinecone Python SDK - Vector database for AI applications
Project-URL: Homepage, https://www.pinecone.io
Project-URL: Documentation, https://docs.pinecone.io
Project-URL: Repository, https://github.com/pinecone-io/python-sdk
Project-URL: Issues, https://github.com/pinecone-io/python-sdk/issues
Project-URL: Changelog, https://github.com/pinecone-io/python-sdk/releases
Author-email: "Pinecone Systems, Inc." <support@pinecone.io>
Maintainer-email: "Pinecone Systems, Inc." <support@pinecone.io>
License: Apache-2.0
License-File: LICENSE
Keywords: ai,database,embeddings,machine-learning,pinecone,search,vector
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx[http2]>=0.27
Requires-Dist: msgspec>=0.19
Requires-Dist: orjson>=3.10
Provides-Extra: dev
Requires-Dist: ipykernel>=6.29; extra == 'dev'
Requires-Dist: jupyter>=1.0; extra == 'dev'
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pre-commit>=3.6; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.1; extra == 'dev'
Requires-Dist: pytest-testmon>=2.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: python-dotenv>=1.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.3; extra == 'dev'
Provides-Extra: docs
Requires-Dist: myst-parser<5.0.0,>=4.0.1; extra == 'docs'
Requires-Dist: sphinx-autodoc-typehints>=2.0; extra == 'docs'
Requires-Dist: sphinx>=7.2; extra == 'docs'
Provides-Extra: performance
Requires-Dist: uvloop>=0.20; extra == 'performance'
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
Requires-Dist: pytest-cov>=4.1; extra == 'test'
Requires-Dist: pytest-testmon>=2.0; extra == 'test'
Requires-Dist: pytest>=8.0; extra == 'test'
Requires-Dist: python-dotenv>=1.0; extra == 'test'
Requires-Dist: respx>=0.21; extra == 'test'
Description-Content-Type: text/markdown

# Pinecone Python SDK

[![Verification](https://github.com/pinecone-io/python-sdk/actions/workflows/verification.yaml/badge.svg)](https://github.com/pinecone-io/python-sdk/actions/workflows/verification.yaml)
[![codecov](https://codecov.io/gh/pinecone-io/python-sdk/branch/main/graph/badge.svg)](https://codecov.io/gh/pinecone-io/python-sdk)
[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

## Development

### Setup

```bash
# Initialize git submodules (optional, internal Pinecone employees only)
# The apis submodule contains OpenAPI specs and is not required for SDK development
git submodule update --init

# Install dependencies with uv
uv sync

# Install pre-commit hooks
pre-commit install
```

**Note:** The `apis/` submodule is only accessible to Pinecone employees. External contributors can develop and test the SDK without it.

### Interactive Testing

**REPL:** Quickly test and experiment with the SDK using the interactive REPL:

```bash
uv run repl
```

The REPL automatically:
- Loads environment variables from `.env`
- Creates pre-configured `pc` (sync) and `apc` (async) client instances using `PINECONE_API_KEY`
- Sets up logging for debugging
- Maintains command history across sessions

Example session:

```python
>>> pc.inference.embed(model="multilingual-e5-large", inputs=["hello world"])
>>> await apc.inference.embed(model="multilingual-e5-large", inputs=["hello world"])
```

**Jupyter Notebooks:** For more exploratory testing or creating demos, ask your AI assistant to create a test notebook:

```
"Create a jupyter notebook to test the embeddings API"
```

This will generate `notebooks/test_TIMESTAMP.ipynb` with automatic environment setup and client initialization. It will load environment variables from your `.env` file. See [.cursor/skills/jupyter-notebook/SKILL.md](.cursor/skills/jupyter-notebook/SKILL.md) for details.

### Maintaining this package with AI coding assistants

This repository includes rules, skills, and agents for AI coding assistants. Both Cursor and Claude Code are supported.

**📖 New to this repository? Start with [HUMANS.md](HUMANS.md)** - A complete guide showing how to work effectively with AI assistants in this codebase, including realistic workflows and examples.

- **Cursor users**: Configuration files are in `.cursor/` directory
- **Claude Code users**: Access via `.claude/` symlinks (points to same files)
- **Editing**: Changes made through either tool are immediately available to the other

The configuration includes:
- **Rules** (`.cursor/rules/`): Architecture, naming conventions, commit messages, documentation style, error handling, testing patterns
- **Skills** (`.cursor/skills/`): Common development tasks like adding methods, implementing protocols, writing tests
- **Agents** (`.cursor/agents/`): Code reviewers for async patterns, docstrings, performance, security, and test quality

For technical details, see [AGENTS.md](AGENTS.md).

## Documentation

### User Documentation

Build the Sphinx documentation:

```bash
# Build HTML documentation (dependencies installed via uv sync)
cd docs
make html

# Open in browser
open _build/html/index.html
```

Other useful commands:

```bash
make doctest    # Test code examples in docstrings
make linkcheck  # Verify all links work
make coverage   # Check documentation coverage
make clean      # Remove build artifacts
```

### Developer Documentation

- [Architecture](docs/architecture/) - System design and architecture
- [Conventions](docs/conventions/) - Coding standards and patterns
- [Development Workflow](docs/development-workflow.md) - Step-by-step guides for common tasks

---

*Last audited: February 5, 2026*
