@graphysdk/agents-sdk
v1.8.1-beta.1787852505522
Published
TypeScript client for the Graphy Agents API
Readme
@graphysdk/agents-sdk
TypeScript client for the Graphy Agents API.
Learn more at graphy.dev.
Install
npm install @graphysdk/agents-sdkYou need an Agents API key for HTTP calls.
Docs
Datasets
Chart requests accept either inline config.data or a staged datasetRef (graphy://attachments/{uuid}).
Upload a CSV, TSV, or XLSX file with uploadDataset(file), then pass the returned datasetRef to generateGraph, generateGraphStream, and the other graph-generation methods. Do not send both inline data and a datasetRef.
See the Agents docs for size limits.
Extract
See the Agents API docs for route limits and runtime behaviour.
Prefer attachments[] over images[]. Do not send both.
| kind | Purpose | Helper |
| --------------- | -------------------- | ---------------------------- |
| "image" | PNG, JPEG, WebP, GIF | buildImageAttachment |
| "document" | PDF | buildPdfAttachment |
| "spreadsheet" | Excel .xlsx | buildSpreadsheetAttachment |
Spreadsheet payloads must be RFC 4648 base64 (no data: prefix) with MIME type application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.
Agent skills
Install the Graphy agent skills from github.com/graphysdk/skills to set up the SDK and author charts from Cursor, Claude Code, and other coding agents.
Licence
This package is available under PolyForm Noncommercial, Small Business, or a 32-day Free Trial. Free Trial is local or internal evaluation only — it does not cover a public page. See what you can do under the trial.
For a commercial licence, talk to us.
Support
Questions and community help: Discord.
