Inferable from Scratch

This guide will walk you through creating a minimal NodeJS project to integrate with Inferable. This is an example that steps through the core concepts of Inferable.

Prerequisites

Make sure you have Node.js installed and have set up your Inferable machine key as an environment variable (INFERABLE_API_SECRET).

You can get your API secret by running:

# npm install -g @inferable/cli
inf auth keys create --type=cluster_machine minimal_example_key

Install dependencies

Install the necessary packages:

npm init -y
npm install inferable zod

Initialize the Inferable client

Create a new file called index.ts and add the following code to initialize the Inferable client:

import { Inferable } from "inferable";
import { z } from "zod";

// Initialize the Inferable client
const client = new Inferable({
  apiSecret: process.env.INFERABLE_API_SECRET,
});

Now, let’s add a function that greets users:

// Define the greeting function
client.default.register({
  name: "greetUser",
  description: "Greets a user by name",
  schema: {
    input: z.object({
    name: z.string(),
  }),
  },
  func: async (input: { name: string }) => {
    return `Hello, ${input.name}! Welcome to Inferable.`;
  },
});

Start the service

Finally, let’s start the service:

// Start the service
inferable.default.start().then(() => {
  console.log("Greeting service is running...");
})

Run the project

To run this example, save the file as app.js and execute it using Node.js:

INFERABLE_API_SECRET=****** tsx index.ts

Here’s the complete app.js file that puts all the steps together:

import { Inferable } from "inferable";
import { z } from "zod";

// Initialize the Inferable client
const client = new Inferable({
  apiSecret: process.env.INFERABLE_API_SECRET,
});

// Create a new service
const greetingService = client.service({ name: "GreetingService" });

// Define the greeting function
greetingService.register({
  name: "greetUser",
  description: "Greets a user by name",
  schema: {
    input: z.object({
      name: z.string(),
    }),
  },
  func: async (input) => {
    return `Hello, ${input.name}! Welcome to Inferable.`;
  },
});

// Start the service
greetingService.start().then(() => {
  console.log("Greeting service is running...");
  console.log("You can now invoke the greetUser function with a run.");
});

Interacting with the service

Now that you have the service running, you can interact with it via:

The Inferable App Web UI
The Inferable CLI with inf runs create "YOUR PROMPT"
The Inferable API.

Getting Started

Guides

Concepts

API

Advanced

Enterprise

Inferable from Scratch

Prerequisites

Interacting with the service

Getting Started

Guides

Concepts

API

Advanced

Enterprise

​Prerequisites

​Interacting with the service

Prerequisites

Interacting with the service