SDK Integration

Software Development Kits

Faramesh provides SDKs for Python and Node.js, making it easy to integrate governance into your agent code with type safety and modern APIs.

What are SDKs?

Convenient wrappers around the REST API

SDKs provide convenient wrappers around the Faramesh REST API, handling authentication, retries, error handling, and response parsing. Use SDKs to submit actions, check status, and handle approvals programmatically.

Python SDK

For Python-based agents

  • Type-safe Python client
  • Full async support
  • Rich error handling

Node.js SDK

For Node.js/JavaScript-based agents

  • TypeScript-first
  • Modern async/await
  • Full type definitions

Core Functionality

All SDKs provide these essential features

Submit Actions
Send actions to Faramesh for evaluation
Get Action Status
Check the current status of an action
List Actions
Query actions with filters
Error Handling
Proper exception handling for timeouts, auth failures, etc.
Retry Logic
Automatic retries with exponential backoff
Approval Management
Approve or deny actions programmatically

Configuration

Flexible configuration options

Environment Variables
FARA_API_BASE, FARA_AUTH_TOKEN
Programmatic Configuration
Configure directly in code with type safety

Python SDK

Integrate FaraCore into Python agents with the ExecutionGovernorClient.

View Python SDK→

Node.js SDK

Use FaraCore in Node.js/JavaScript agents with the submitAction API.

View Node.js SDK→
Previous
Policy Recipes
Next
Python SDK