Skip to main content

WCS Quickstart


Welcome to the Quickstart guide for Weaviate Cloud Services (WCS). Here, you will learn:

  • How to set up a Weaviate instance on WCS, and
  • How to instantiate a Weaviate client to communicate with the WCS instance.


By the end of this tutorial, you will be familiar with the basics of WCS. You will have:

  • Created a WCS account,
  • Created a new free WCS sandbox instance without authentication,
  • Installed a Weaviate client of your choice, and
  • Queried your new WCS sandbox instance with the Weaviate client.

And if you wish, you will be ready to move onto our Weaviate Quickstart tutorial next.

Sign in to WCS

  1. First, go to the WCS Console, and click on "Sign in with the Weaviate Cloud Services".
    1. Click Sign in with the Weaviate Cloud Services.
    2. If you don't have a WCS account, click on Register.
  2. Sign in with your WCS username and password.

Create a Weaviate Cluster

To create a new Weaviate Cluster, click the Create cluster button.


  1. Select the Free sandbox tier.
  2. Provide a Cluster name. This will become a part of its URL, with a suffix added to ensure uniqueness.
  3. Set Enable Authentication? to YES.

Click Create. This will take ~2 minutes and you'll see a tick ✔️ when finished.

This will start the process to create a new instance, and you will see a progress indicator.

Creation in progress

Instance creation should take a minute or two, and you will see a tick ✔️ when it's done, indicating that the instance is ready.

Your cluster details

To access your cluster, you will need:

  • The Weaviate URL, and
  • Authentication details (Weaviate API key).

Click Details to see them.

For the Weaviate API key, click on the API keys button.

Sandbox expiration

The sandbox is free, but it will expire after 14 days. After this time, all data in the sandbox will be deleted.

If you would like to preserve your sandbox data, you can retrieve your data, or contact us to upgrade to a production SaaS instance.

In the meantime, let's start installing a client library.

Install a client library

We suggest using a Weaviate client. To install your preferred client :

You can perform all Weaviate requests with any of these clients. For the most seamless and language-native experience, we recommend using the client for your preferred programming language.

Install your preferred client by following the relevant instructions below:

Add weaviate-client to your Python environment with pip.

Please note that the v4 client requires Weaviate 1.22 or higher.

(The v4 client is currently in beta.)

pip install --pre "weaviate-client==4.4b0"

Connect to your WCS instance

By now, you should have:

  • Set up a sandbox instance of Weaviate on WCS, and
  • Installed a Weaviate client library.

From the Details tab in WCS, get:

  • The Weaviate API key, and
  • The Weaviate URL.

Replace the endpoint address and API key in the following code with your address and key, then run the code for your preferred client:

import weaviate

client = weaviate.Client(
url="", # Replace with your endpoint
auth_client_secret=weaviate.AuthApiKey(api_key="YOUR-WEAVIATE-API-KEY"), # Replace w/ your Weaviate instance API key


You should receive a response confirming the server is ready.


Congratulations! You have successfully set up a cloud-based vector database with WCS.


Now that you are set up with a WCS instance:

  • If you are new to Weaviate at large, we recommend moving to the Weaviate Quickstart Tutorial.
  • Otherwise, we hope you enjoy your experience with WCS.

More resources

Is something broken?

We want you to have the best experience possible here. So if you find that something here doesn't work, or doesn't make sense, please let us know! You can:

Support & Troubleshooting

All Weaviate users are welcome to join our community Slack and forum.

Additionally, paid customers can also contact support via channels provided during cluster creation and/or on-boarding.

For general contact details please see this page.

Inference API status pages