Skip to content
Raindrop Developer Hub

Creating a SmartBucket

Overview

SmartBuckets are intelligent storage containers that give you powerful search and conversational AI capabilities for your documents and data. They are managed through Raindrop applications, which provides several benefits:

  • Full versioning capabilities
  • Consistent deployment patterns
  • Resource management
  • Access control integration

Prerequisites

Before creating a SmartBucket, ensure you have:

Step-by-Step Creation Process

1. Install Raindrop CLI

First, install the latest version of the Raindrop CLI:

Terminal window
npm install -g @liquidmetal-ai/raindrop@latest

2. Create a SmartBucket Application

Create a new SmartBucket application by cloning our template:

Terminal window
raindrop build clone liquidmetal/smartbucket my-app

This command:

  • Creates a new application directory with the name my-app
  • Sets up all necessary configuration files
  • Creates a SmartBucket in my-app called my-app-smartbucket
  • When prompted, type “Y” to create a SmartBucket in your organization

3. Navigate to Your Application Directory

Terminal window
cd my-app

4. Deploy and Start Your SmartBucket

Deploy and start your SmartBucket with these commands:

Terminal window
raindrop build deploy
raindrop build start
raindrop build status -o watch

These commands:

  • Deploy your SmartBucket configuration
  • Start the SmartBucket service
  • Monitor the deployment status

6. Upload Your First Document

Upload documents to your SmartBucket using:

Terminal window
raindrop object put <path-to-file> <key> -b my-app-smartbucket

Note: The key is the name you give to the document in your SmartBucket. Please note that you must use a unique key for each document.

Note: The flag -b is followed by my-app-smartbucket, which is the name of your SmartBucket.

7. List Files in Your SmartBucket

View all documents in your SmartBucket:

Terminal window
raindrop object list -b my-app-smartbucket

8. Search and Interact With Your Content

Search across all your documents and have conversations with your data:

Terminal window
raindrop query search 'Your search query' -b my-app-smartbucket

Next Steps

After creating your SmartBucket, you can: