Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wazoo.dev/llms.txt

Use this file to discover all available pages before exploring further.

The fastest way to understand Worlds is to interact with it natively. This quickstart skips the theory and drops you straight into the API to execute your first neuro-symbolic query.

​
Prerequisites

Before writing code, you need a Worlds API key.
  1. Sign up at the Worlds Console.
  2. Generate an API key.
  3. Save it securely to your .env file as WORLDS_API_KEY.

​
Hello, World!

Follow this sequence to train on the core interaction loop: connect to the cloud engine, inject a verifiable fact, and retrieve it deterministically.
1

Install the API

Install the canonical TypeScript client.
deno add jsr:@wazoo/worlds-sdk
2

See it in action

Run the following self-contained script to execute a complete neuro-symbolic loop:
  1. Connect to the Cloud API.
  2. Create an isolated World.
  3. Inject a semantic fact (triple).
  4. Query that fact deterministically using SPARQL.
index.ts
import { Worlds } from "@wazoo/worlds-sdk";

// 1. Connect (Drop directly into the cloud engine)
const worlds = new Worlds({
  apiKey: process.env.WORLDS_API_KEY!,
  baseUrl: "https://api.wazoo.dev",
});

// 2. Create an isolated world
const world = await worlds.create({
  slug: "quickstart-cloud",
  label: "My First World",
});

// 3. Inject a mission-critical fact (Subject -> Predicate -> Object)
await worlds.import(
  "quickstart-cloud",
  `@prefix user: <https://etok.me/#> .
  @prefix wazoo: <https://wazoo.dev/#> .
  user:person wazoo:worksFor wazoo:organization .`,
  { contentType: "text/turtle" },
);

// 4. Retrieve the fact with absolute precision
const result = await worlds.sparql(
  "quickstart-cloud",
  `PREFIX wazoo: <https://wazoo.dev/#>
  SELECT ?wazoo WHERE { <https://etok.me/#person> wazoo:worksFor ?wazoo }`,
);

console.log("Verifiable context retrieved:", JSON.stringify(result, null, 2));
3

Analyze the output

The system executes the query and returns the fact exactly as you injected it, without guessing.
Verifiable context retrieved:
{
  "head": {
    "vars": ["wazoo"]
  },
  "results": {
    "bindings": [
      {
        "wazoo": { "type": "uri", "value": "https://wazoo.dev/#organization" }
      }
    ]
  }
}
You have completed the fundamental loop of interacting with high-stakes verifiable context.

​
Next steps

Now that you have securely connected to your cloud instance, integrate the API directly into your agentic loops.

AI agent integration

Grant an AI agent direct access to construct its own Worlds.

Self-hosting

Host the Worlds API infrastructure on your own hardware.