Registry /
workflow / apache-airflow-providers-weaviate
Install & Compatibility
Where this runs
tested against v3.3.4 · 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
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 8.214s · 405.5MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 30.7s · import 7.003s · 395MB
407MB installed
● package 407MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
WeaviateHook
✓ from airflow.providers.weaviate.hooks.weaviate import WeaviateHook
✗ from airflow.hooks.weaviate import WeaviateHook
Old provider structure; imports changed to providers namespace.
WeaviateIngestOperator
✓ from airflow.providers.weaviate.operators.weaviate import WeaviateIngestOperator
WeaviateDocumentParser
✓ from airflow.providers.weaviate.hooks.hooks import WeaviateDocumentParser
Minimal DAG to test Weaviate connection using the provider hook.
from datetime import datetime
from airflow import DAG
from airflow.operators.python import PythonOperator
from airflow.providers.weaviate.hooks.weaviate import WeaviateHook
def test_connection():
hook = WeaviateHook(weaviate_conn_id='weaviate_default')
client = hook.get_client()
print(client.is_ready())
with DAG(
dag_id='weaviate_test',
start_date=datetime(2023,1,1),
schedule=None,
catchup=False,
) as dag:
task = PythonOperator(
task_id='test_conn',
python_callable=test_connection
)
airflow --version
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'airflow.hooks.weaviate'
Trying to import hook from old deprecated path.
fixUse `from airflow.providers.weaviate.hooks.weaviate import WeaviateHook`.
AttributeError: 'WeaviateHook' object has no attribute 'get_conn'
Using deprecated method after provider update.
fixReplace `hook.get_conn()` with `hook.get_client()`.
weaviate.exceptions.WeaviateClosedError: the client is closed
Reusing a closed client or not properly managing hook lifecycle.
fixEnsure each task uses the hook to obtain a fresh client; do not share clients across tasks without reopening.
Upgrade
Version history
3.3.4latest on PyPI · released May 23, 2026
Audit
Dependencies
apache-airflowrequiredCore dependency; requires >=2.10.0
weaviate-clientrequiredWeaviate Python client for API calls
apache-airflow-providers-common-sqloptionalUsed for SQL-like hooks and operators