App | Docs | Blog

Install the package from npm with your favorite package manager

npm install @cherrry-ai/cherrry-js

From https://cherrry.com/dashboard/api to get your API Keys

Private keys start with ch_prv

keep it secret and never use it client-side. It has service role privilages: it can read + write data.

Public keys start with ch_pub

They're intended to be use client-side and have read-only privilages.

const CherrryClient = require("@cherrry-ai/cherrry-js");

or

import CherrryClient from "@cherrry-ai/cherrry-js";

initialize the client

const client = new CherrryClient(api_key);

A table is a collection of documents.

A document is respresented as a JSON object literal with three fields: text, image, and metadata. These fields are also JSON object literals, where the keys can be strings with any contents, and their values are also strings.

text and image are semantically searchable each by their type respectively. Each document must have either a text or image field. It can also have both fields. metadata is used to store additional information and for filtering (feature in progress), it is an optional field.

var { data, error } = await client.create_table("example_table");

Documents must be of the following form

{
    "text": {
        "a name for your text": "your desired text in a string"
    },
    "image": {
        "a name for your image": "a url to your downloadable image"
    },
    "metadata": {
        "key": "value"
    }
}

for example:

var { data, error } = await client.from("recipes").insert({
    text: {
        name: "Octopus Cherry Pie"
    },
    image: {
        preview: "https://i.imgur.com/lFC8p0L.jpeg"
    },
    data: {
        author_name: "Davy Jones",
        author_email: "[email protected]"
    }
});

var { data, error } = await client
    .from("blogs")
    .search({ prompt: "sea creature desert", size: 1, search_type: "image" });

The ID of documents are returned in the responses of /search or /doc

var { data, error } = await client.from("blogs").doc("1234");

var { success, error } = await client.from("blogs").delete("1234");