SDKs - EigenPal Docs

EigenPal provides an agent authoring SDK and API client SDKs. Choose the package for the code you are writing: an agent definition in Git, or an application that calls EigenPal.

Define an agent

Use @eigenpal/automations to author agent.ts and shared resource.ts definitions. It includes typed tools, schemas, guards, optional filesystem access and evaluation logic. Definitions live in your organization’s Git repository. Constructing a definition needs no API key; validating and releasing against a deployment uses CLI authentication. Start with the agent authoring SDK.

Call EigenPal from your application

Use @eigenpal/sdk for TypeScript or eigenpal for Python to call the REST API. Authenticate with an API key to start workflow/agent runs, inspect results, upload files, manage datasets and run experiments. The API clients are generated from the same OpenAPI specification.

Agent authoring

@eigenpal/automations: define agents, resources, tools and evaluations in TypeScript.

TypeScript API client

@eigenpal/sdk: call EigenPal from your application.

Python API client

eigenpal: call EigenPal from Python.

Use the packages together

Author and release agents/invoice-reviewer/agent.ts with @eigenpal/automations. Then start it from an application using the API client:

import { EigenpalClient } from '@eigenpal/sdk';

const client = new EigenpalClient({ apiKey: process.env.EIGENPAL_API_KEY });
const result = await client.run(
  'agents.invoice-reviewer',
  { subtotal: 100 },
  { waitForCompletion: 60 }
);

Get an API key under Settings → API Keys. Point the API client at a self-hosted deployment with baseUrl (TypeScript) or base_url (Python). The authoring package does not provide client.run, and the API client does not define tools or evaluators. Use the CLI to clone, validate, save and release agent source. See the API reference for HTTP endpoints. All three packages are open source: authoring SDK, TypeScript API client, and Python API client.

​Define an agent

​Call EigenPal from your application