weaviate

name	weaviate
description	Operates Weaviate Cloud or self-hosted collections with weaviate-client v4: list/create, import, semantic/hybrid/keyword search, Query Agent. Use when the user names Weaviate. Not for local Chroma (chroma), Pinecone serverless (pinecone), or FAISS-only kNN. Never hardcode WEAVIATE_API_KEY.
version	1.0.1
category	databases
risk	critical
source	community
source_repo	weaviate/agent-skills
source_type	official
date_added	2026-06-29
author	Weaviate
tags	["weaviate","vector-database","semantic-search","hybrid-search","data-import"]
tools	["python","weaviate"]
license	BSD-3-Clause
license_source	https://github.com/weaviate/agent-skills/blob/main/LICENSE

Weaviate Database Operations

Comprehensive access to Weaviate vector databases: search operations, natural language queries, schema inspection, data exploration, filtered fetching, collection creation, and data imports.

When to Use

• Inspect Weaviate collections, schemas, or data distribution.
• Run semantic, hybrid, keyword, filtered, or Query Agent searches against Weaviate.
• Import CSV, JSON, JSONL, or PDF data into a Weaviate collection.
• Create example data or a new collection for a Weaviate-backed workflow.

Trigger keywords: weaviate, vector database, collection, semantic search, hybrid search, keyword search, query agent, vectorize, import data, schema inspection.

Weaviate Cloud Instance

If the user does not have an instance yet, direct them to the cloud console to register and create a free sandbox: Weaviate Cloud.

Prerequisites

Environment Variables

Required (must be set before any script runs):

Variable	Purpose
WEAVIATE_URL	Weaviate Cloud cluster URL
WEAVIATE_API_KEY	Weaviate API key

External Provider Keys (auto-detected — set only the keys your collections use):

See references/environment_requirements.md for the full list of supported providers and their variable names. Common ones include OPENAI_APIKEY, COHERE_APIKEY, ANTHROPIC_APIKEY, and AWS_ACCESS_KEY / AWS_SECRET_ACCESS_KEY for the text2vec_weaviate vectorizer.

HARD RULE: Never hardcode secrets in scripts or commit them to version control. Use environment variables or a .env file. All examples in this skill use YOUR_KEY placeholders.

Windows Host (PowerShell)

The primary host is Windows with PowerShell. When setting environment variables in the current session:

$env:WEAVIATE_URL = "https://your-cluster.weaviate.cloud"
$env:WEAVIATE_API_KEY = "YOUR_KEY"

For a persistent user-level setting:

[Environment]::SetEnvironmentVariable("WEAVIATE_URL", "https://your-cluster.weaviate.cloud", "User")
[Environment]::SetEnvironmentVariable("WEAVIATE_API_KEY", "YOUR_KEY", "User")