Quickstart

Get started with the III SDK in minutes

Choose Your Language

The III SDK is available in three languages. Select your preferred language to get started:

Node.js

TypeScript/JavaScript SDK with full async support

Python

Async Python SDK with type hints

Rust

High-performance async Rust SDK

Quick Example

Here’s a minimal example of using the III SDK across all three languages:

Node.js

import { init } from 'iii-sdk'

// Initialize the SDK
const iii = init('ws://localhost:49134')

// Register a function
iii.registerFunction(
  { id: 'greeting' },
  async (data: { name: string }) => {
    return { message: `Hello, ${data.name}!` }
  }
)

// Call the function
const result = await iii.call('greeting', { name: 'World' })
console.log(result.message) // "Hello, World!"

Python

from iii import III

# Initialize the SDK
iii = III("ws://localhost:49134")

# Register a function
async def greeting(data):
    return {"message": f"Hello, {data['name']}!"}

iii.register_function("greeting", greeting)

# Connect and call the function
await iii.connect()
result = await iii.call("greeting", {"name": "World"})
print(result["message"])  # "Hello, World!"

Rust

use iii_sdk::III;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize the SDK
    let iii = III::new("ws://127.0.0.1:49134");
    iii.connect().await?;

    // Register a function
    iii.register_function("greeting", |input| async move {
        let name = input["name"].as_str().unwrap_or("World");
        Ok(json!({ "message": format!("Hello, {}!", name) }))
    });

    // Call the function
    let result = iii.call("greeting", json!({ "name": "World" })).await?;
    println!("{}", result["message"]);  // "Hello, World!"
    
    Ok(())
}

Core Concepts

Before diving deeper, familiarize yourself with these key concepts:

Functions

Register and invoke functions across services

Triggers

Automatically invoke functions based on events

Channels

Stream data bidirectionally between functions

Context & Logging

Access execution context and structured logging

Next Steps

1. Choose your language

   Select Node.js, Python, or Rust and follow the language-specific quickstart guide.

2. Learn core concepts

   Understand the architecture and how functions and triggers work together.

3. Explore advanced features

   Dive into streaming channels, observability, and error handling.