Registry / workflow / apache-airflow-providers-pinecone

apache-airflow-providers-pinecone

library2.4.5pypypi✓ verified 84d ago

Apache Airflow provider for integrating with Pinecone vector database. Version 2.4.4 supports Airflow 2.x and Python >=3.10. Provides hooks and operators to manage Pinecone indexes, upsert vectors, and run queries. Release cadence follows Airflow's provider releases.

workflow vector-search data devops aws

pip install apache-airflow-providers-pinecone

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · APACHE-AIRFLOW-PRO

apache-airflow-providers-pinecone

workflowpythonv2.4.5

Install

24.4s avg

Import

5227ms

Disk

262MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.4.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 5.438s · 263.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 24.4s · import 5.016s · 261MB

262MB installed

● package 262MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

PineconeHook

✓ from airflow.providers.pinecone.hooks.pinecone import PineconeHook

✗ from airflow.providers.pinecone.hooks import PineconeHook

Incorrect parent module; PineconeHook is in hooks.pinecone, not directly in hooks

PineconeIngestOperator

✓ from airflow.providers.pinecone.operators.pinecone import PineconeIngestOperator

✗ from airflow.providers.pinecone.operators import PineconeIngestOperator

Operator is in the pinecone submodule, not directly in operators

Initialize a PineconeHook and create an index. Ensure a Pinecone connection is defined in Airflow.

from airflow.providers.pinecone.hooks.pinecone import PineconeHook hook = PineconeHook(pinecone_conn_id='pinecone_default') hook.create_index(name='test-index', dimension=512, metric='cosine')

airflow --version

Debug

Known issues

breakingIn version 2.4.0, the hook signature changed: `PineconeHook` now requires `pinecone_conn_id` instead of `api_key` and `environment`. Old connections using raw keys will break.

fix

Create an Airflow connection with type 'Pinecone' containing the API key and environment, then pass the connection ID.

affects: >=2.4.0

gotchaThe operator `PineconeIngestOperator` expects input as a list of dictionaries with keys 'id' and 'values', not raw tuples or pandas DataFrames. Converting non-standard formats is the user's responsibility.

fix

Ensure your data is a list of dicts: [{'id': 'vec1', 'values': [0.1, 0.2, ...]}, ...].

affects: all

deprecatedThe method `describe_index_stats` on `PineconeHook` was deprecated in 2.4.3 in favor of `describe_index` which returns full metadata including dimension and metric.

fix

Replace calls to `hook.describe_index_stats(index_name)` with `hook.describe_index(index_name)`.

affects: 2.4.3+

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'airflow.providers.pinecone'

Provider package not installed or Airflow is too old (<2.0) and doesn't support providers.

fix

Install the provider: pip install apache-airflow-providers-pinecone. Ensure you are using Airflow 2.0+.

AttributeError: 'PineconeHook' object has no attribute 'create_index'

Using an older version of the provider (<2.4.0) where create_index was not exposed.

fix

Upgrade to the latest provider: pip install --upgrade apache-airflow-providers-pinecone

Connection to Pinecone failed: SSL error

Missing or incorrect Pinecone environment in connection. The environment must match your Pinecone project (e.g., 'us-west1-gcp').

fix

In Airflow UI, edit the Pinecone connection to include the correct environment, ensure API key is set, and check network/firewall settings.

Upgrade

Version history

2.4.5latest on PyPI · released May 23, 2026

Audit

Dependencies

apache-airflowrequiredRequired runtime dependency

pinecone-clientrequiredOfficial Pinecone Python client

Agent activity

78 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://github.com/apache/airflow ↗

packagehttps://pypi.org/project/apache-airflow-providers-pinecone/ ↗

homepagehttps://www.pinecone.io ↗

docshttps://airflow.apache.org/docs/apache-airflow-providers-pinecone/2.4.4 ↗

changeloghttps://airflow.apache.org/docs/apache-airflow-providers-pinecone/2.4.4/changelog.html ↗