Official TypeScript and Python SDKs for the Imbrace platform.
| Directory | Package | Version | Runtime |
|---|---|---|---|
ts/ |
@imbrace/sdk |
1.0.4 | Node.js 18+, browser |
py/ |
imbrace |
1.0.4 | Python 3.9+ |
TypeScript / JavaScript
npm install @imbrace/sdkPython
pip install imbraceTypeScript
import { ImbraceClient } from "@imbrace/sdk"
const client = new ImbraceClient({
apiKey: process.env.IMBRACE_API_KEY,
})
const contacts = await client.contacts.list({ limit: 20 })
console.log(contacts.data)Python
from imbrace import ImbraceClient
with ImbraceClient() as client:
contacts = client.contacts.list(limit=20)
print(contacts["data"])Set IMBRACE_API_KEY in your environment or .env file. Both SDKs read it automatically.
Full reference, authentication guides, and examples:
Available in: English · Tiếng Việt · 简体中文 · 繁體中文
cd ts
npm install
npm run build # compile to dist/
npm run dev # watch mode
npm run typecheck # type check
npm run lint # lint
npm test # unit tests (no API key needed)cd py
pip install -e ".[dev]" # install with dev tools
pytest tests/unit -v # unit tests (no API key needed)
ruff check src/ tests/ # lint
mypy src/imbrace # type checkcd website
npm install
npm run dev # dev server at localhost:4321
npm run build # production buildIntegration tests make real API calls and require credentials.
TypeScript
cd ts
IMBRACE_API_KEY=api_xxx npm run test:integrationPython
Create py/.env:
IMBRACE_API_KEY=api_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
IMBRACE_BASE_URL=https://app-gatewayv2.imbrace.co
IMBRACE_ORG_ID=org_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxThen:
cd py
pytest tests/integration -v -m integrationapi-sdk/
├── ts/ # TypeScript SDK (@imbrace/sdk)
│ ├── src/ # Source — client, resources, types
│ ├── tests/
│ │ ├── unit/ # Vitest unit tests
│ │ ├── integration/ # Live API tests
│ │ └── local/ # Local package link tests
│ └── dist/ # Compiled output (gitignored)
├── py/ # Python SDK (imbrace)
│ ├── src/imbrace/ # Source — client, resources, types
│ └── tests/
│ ├── unit/ # pytest unit tests
│ └── integration/ # Live API tests
└── website/ # Docs site (Astro Starlight)
└── src/content/docs/
├── (en root)
├── vi/
├── zh-cn/
└── zh-tw/
MIT — see LICENSE.
