SDKs

Moonbase provides SDKs for TypeScript/JavaScript, Python, Go, and Ruby. SDKs handle authentication, request formatting, and response parsing. Built-in retries handle rate limits and transient errors.

Prerequisites

API key from organization settings.
Review the authentication guide.

Keep API keys secret. Avoid client-side exposure.

Installation and usage

TypeScript
Python
Go
Ruby

Install the TypeScript SDK using npm:

npm install @moonbaseai/sdk

yarn add @moonbaseai/sdk

pnpm add @moonbaseai/sdk

bun add @moonbaseai/sdk

Usage:

import Moonbase from '@moonbaseai/sdk';

const moonbase = new Moonbase({
  apiKey: process.env.MOONBASE_API_KEY, // This is the default and can be omitted
});

const collection = await moonbase.collections.retrieve('organizations');

console.log(collection.id);

TypeScript SDK on GitHub

View documentation, examples, and source code for the TypeScript SDK.

Install the Python SDK using pip:

pip install --pre moonbase-sdk

Usage:

import os
from moonbase import Moonbase

moonbase = Moonbase(
    api_key=os.environ.get("MOONBASE_API_KEY"),  # This is the default and can be omitted
)

collection = moonbase.collections.retrieve(
    id="organizations",
)
print(collection.id)

Python SDK on GitHub

View documentation, examples, and source code for the Python SDK.

Install the Go SDK:

go get github.com/moonbaseai/moonbase-sdk-go@v0.1.0-alpha.2

Usage:

package main

import (
	"context"
	"fmt"

	"github.com/moonbaseai/moonbase-sdk-go"
	"github.com/moonbaseai/moonbase-sdk-go/option"
)

func main() {
	client := moonbase.NewClient(
		option.WithAPIKey(os.Getenv("MOONBASE_API_KEY")), // This is the default and can be omitted
	)
	collection, err := client.Collections.Get(
		context.TODO(),
		"organizations",
		moonbase.CollectionGetParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", collection.ID)
}

Go SDK on GitHub

View documentation, examples, and source code for the Go SDK.

Install the Ruby SDK:

gem "moonbase-sdk", "~> 0.1.0.pre.alpha.2"

Then run:

bundle install

Usage:

require "bundler/setup"
require "moonbase"

moonbase = Moonbase::Client.new(
  api_key: ENV["MOONBASE_API_KEY"] # This is the default and can be omitted
)

collection = moonbase.collections.retrieve("organizations")

puts(collection.id)

Ruby SDK on GitHub

View documentation, examples, and source code for the Ruby SDK.

⌘I

Introduction

Core Concepts

API Reference

Prerequisites

Installation and usage

TypeScript SDK on GitHub

Python SDK on GitHub

Go SDK on GitHub

Ruby SDK on GitHub

​Prerequisites

​Installation and usage

TypeScript SDK on GitHub

Python SDK on GitHub

Go SDK on GitHub

Ruby SDK on GitHub

Prerequisites

Installation and usage