Client Basics

pip install pie-client

npm install @pie-project/client

cargo add pie-client

from pie_client import PieClient
 
# Connect to server
client = PieClient("http://localhost:8080")
 
# Run an inferlet
result = client.run(
    inferlet="std/text-completion",
    args={
        "prompt": "Explain quantum computing:",
        "max_tokens": 100
    }
)
 
print(result.output)

import { PieClient } from '@pie-project/client';
 
const client = new PieClient('http://localhost:8080');
 
const result = await client.run({
  inferlet: 'std/text-completion',
  args: {
    prompt: 'Explain quantum computing:',
    max_tokens: 100
  }
});
 
console.log(result.output);

# Submit job
job_id = client.submit(
    inferlet="std/text-completion",
    args={"prompt": "Long task..."}
)
 
# Poll for completion
import time
while True:
    result = client.get_result(job_id)
    if result.is_complete:
        print(result.output)
        break
    time.sleep(1)

for chunk in client.stream(
    inferlet="std/text-completion",
    args={"prompt": "Tell me a story"}
):
    print(chunk, end="", flush=True)

const stream = await client.stream({
  inferlet: 'std/text-completion',
  args: { prompt: 'Tell me a story' }
});
 
for await (const chunk of stream) {
  process.stdout.write(chunk);
}

# Upload your custom inferlet
client.upload_inferlet(
    name="my-inferlet",
    wasm_path="./my_inferlet.wasm"
)
 
# Use it
result = client.run(
    inferlet="my-inferlet",
    args={"input": "test"}
)

from pie_client import PieError
 
try:
    result = client.run(
        inferlet="my-inferlet",
        args={"prompt": "test"}
    )
except PieError as e:
    print(f"Error: {e.message}")
    print(f"Code: {e.code}")

try {
  const result = await client.run({
    inferlet: 'my-inferlet',
    args: { prompt: 'test' }
  });
} catch (error) {
  if (error instanceof PieError) {
    console.error('Error:', error.message);
  }
}

client = PieClient(
    "http://localhost:8080",
    timeout=60  # seconds
)

client = PieClient(
    "http://localhost:8080",
    max_retries=3,
    retry_delay=1.0
)

client = PieClient(
    "http://localhost:8080",
    api_key="your-api-key"
)