Quickstart

1. Get a personal access token

   Sign in at renai.build, open Settings → Personal access tokens, and create a new token. Copy it — you won’t be able to see it again.

   Export it as an environment variable:

   export REN_PAT_TOKEN="ren_pat_xxxxxxxx"

2. Install the SDK

   npm install @renai-labs/sdk

   Or with Bun:

   bun add @renai-labs/sdk

3. Create a client

   Create quickstart.ts:

   import { createRenClient, pat } from "@renai-labs/sdk"
   
   const client = createRenClient({
     baseUrl: "https://api.renai.build",
     auth: pat(process.env.REN_PAT_TOKEN!),
   })
   
   const { data, error } = await client.pod.list()
   
   if (error) {
     console.error(error)
     process.exit(1)
   }
   
   console.log(data)

4. Run it

   bun run quickstart.ts

   You should see an array of your pods printed to the terminal:

   [
     {
       "id": "pod_01h...",
       "name": "My first pod",
       "createdAt": "2026-04-22T12:00:00Z"
     }
   ]

What’s next

• Core concepts — understand what pods, projects, agents, skills, and routines are before you build something real.
• SDK client — configure timeouts, headers, custom fetch, and error handling.
• Run an agent — end-to-end walkthrough from creating an agent to running it in a session.