Skip to main content

Weaviate

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Weaviate account to Nirvai to store and search vector embeddings. Weaviate is an open-source vector database that enables AI-native applications with semantic search capabilities.

Supported Authentication Methods​

  • API Key + Host URL - Required

Prerequisites​

Setup Instructions​

Option 1: Weaviate Cloud​

Step 1: Create a Weaviate Cloud Account​

  1. Go to Weaviate Cloud Console
  2. Sign up for an account (free sandbox available)

Step 2: Create a Cluster​

  1. Create a new Weaviate Cloud Database
  2. Choose your cluster configuration
  3. Wait for deployment to complete

Step 3: Get Your Credentials​

  1. In your cluster details, find:
    • Weaviate Cloud Endpoint: Your cluster URL
    • Weaviate API Key: Your authentication key
  2. Copy both values

Note: Weaviate provides a free sandbox option for testing.

Option 2: Self-Hosted (Custom Connection)​

  1. Deploy Weaviate on your own server
  2. Configure API key authentication
  3. Note your connection details:
    • API Key: Your Weaviate API key
    • HTTP Host: Domain or IP for HTTP API calls
    • HTTP Port: Usually 8080
    • gRPC Host: For gRPC connections
    • gRPC Port: Usually 50051

Step 4: Add to Nirvai​

  1. In Nirvai, create a new Weaviate credential
  2. Enter your API key
  3. Enter your Weaviate endpoint in the Host URL field
  4. Save the credential

Features​

Weaviate provides:

  • Vector + keyword search: Hybrid search capabilities
  • GraphQL API: Flexible querying
  • Module ecosystem: Vectorizers, readers, generators
  • Multi-tenancy: Isolate data per tenant

Troubleshooting​

Cannot Connect​

  • Verify the endpoint URL is correct
  • Check if the cluster is running
  • Ensure HTTPS is configured correctly

API Key Not Working​

  • Verify the key format and permissions
  • Check if the key has been rotated
  • Ensure you're using the correct cluster

gRPC Connection Issues​

  • Verify gRPC port is accessible
  • Check firewall settings
  • Ensure TLS is configured if required

Documentation adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.