Drive MANTYX agents from your code.

Drive MANTYX agents from your code.

MANTYX runs the full agent loop, workspace tools, memory, and observability. These SDKs connect your process to that runtime so you can mix remote tools with local handlers in one loop.

Get started View on GitHub

Pick your stack

Same wire protocol, three first-party clients.

TypeScript

@mantyx/sdk

npm install @mantyx/sdk zod

Runtime: Node.js 18.17+

Reference →

Go

github.com/mantyx-io/mantyx-sdk/go

go get github.com/mantyx-io/mantyx-sdk/go

Runtime: Go 1.22+

Reference →

Python

mantyx-sdk

pip install mantyx-sdk

Runtime: Python 3.9+

Reference →

A one-shot run, in any language

Same call shape across all three SDKs — pick the tab for your stack.

TypeScript

oneshot.ts

import { MantyxClient, defineLocalTool } from "@mantyx/sdk";
import { z } from "zod";
import { readFile } from "node:fs/promises";

const client = new MantyxClient({
  apiKey: process.env.MANTYX_API_KEY!,
  workspaceSlug: "acme-corp",
});

const result = await client.runAgent({
  systemPrompt: "You are a helpful filesystem assistant.",
  prompt: "Read /etc/hostname and tell me what it says.",
  tools: [
    defineLocalTool({
      name: "read_file",
      parameters: z.object({ path: z.string() }),
      execute: ({ path }) => readFile(path, "utf8"),
    }),
  ],
});
console.log(result.text);

Go

oneshot.go

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"
    "os"

    mantyx "github.com/mantyx-io/mantyx-sdk/go"
)

type readFileArgs struct {
    Path string `json:"path" jsonschema:"description=Path to read"`
}

func main() {
    client := mantyx.NewClient(mantyx.Options{
        APIKey:        os.Getenv("MANTYX_API_KEY"),
        WorkspaceSlug: "acme-corp",
    })

    tool := mantyx.LocalTool(mantyx.LocalToolSpec{
        Name:       "read_file",
        Parameters: &readFileArgs{},
        Execute: func(ctx context.Context, raw json.RawMessage) (string, error) {
            var args readFileArgs
            if err := json.Unmarshal(raw, &args); err != nil {
                return "", err
            }
            b, err := os.ReadFile(args.Path)
            return string(b), err
        },
    })

    result, err := client.RunAgent(context.Background(), mantyx.RunSpec{
        SystemPrompt: "You are a helpful filesystem assistant.",
        Prompt:       "Read /etc/hostname.",
        Tools:        []mantyx.ToolRef{tool},
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text)
}

Python

oneshot.py

import os
from pathlib import Path
from pydantic import BaseModel
from mantyx import MantyxClient, define_local_tool

class ReadFileArgs(BaseModel):
    path: str

client = MantyxClient(
    api_key=os.environ["MANTYX_API_KEY"],
    workspace_slug="acme-corp",
)

result = client.run_agent(
    system_prompt="You are a helpful filesystem assistant.",
    prompt="Read /etc/hostname and tell me what it says.",
    tools=[
        define_local_tool(
            name="read_file",
            parameters=ReadFileArgs,
            execute=lambda args: Path(args.path).read_text(),
        ),
    ],
)
print(result.text)

Ready to ship an agent?

Read the quickstart Wire protocol