Install and authenticate

Authenticate SDK clients with an organization API key so requests run under your tenant’s policy and audit trail.

Steps

Obtain credentials

Create or rotate an API key in Account Settings — Tokens and API keys. Scope the key to the minimum environments required.

Install the SDK


pip install exemplar-harness-sdk
 
# One agent framework (pick what you use)
pip install "exemplar-harness-sdk[agno]"
pip install "exemplar-harness-sdk[openai]"
pip install "exemplar-harness-sdk[google-adk]"
pip install "exemplar-harness-sdk[claude-agent]"
 
# Everything
pip install "exemplar-harness-sdk[all]"

Requires Python 3.10–3.13.

Configure the environment


export EXEMPLAR_API_KEY="eis_your_org_api_key"

Optional overrides:

Variable	Purpose
`EXEMPLAR_BASE_URL`	API host override
`EXEMPLAR_ENV`	`production` (default), `development`, or `local`
`EXEMPLAR_ORGANIZATION_ID`	Org override when needed
`EXEMPLAR_MCP_URL`	MCP endpoint override (defaults to `{base_url}/mcp`)

Default production base URL: https://production-api.exemplar.dev.

Create a client


from exemplar_harness import Harness
 
harness = Harness.from_env()

Never commit keys to source control or agent context.

The terminal CLI is a separate package: pip install exemplar-cli (or pipx install exemplar-cli). See CLI install and authenticate.

Client usage — memory, skills, prompts, ingest, and framework hooks
CLI install and authenticate