Installation
Install one SDK and set the minimum environment variables.
Before you start, make sure your operator has completed Deployment and given you a base URL plus an organization ID.
Pick one runtime. The Python and TypeScript SDKs call the same backend, so choose the one that already owns your orchestration logic.
These docs target the 1.x SDKs. Keep the major version constrained so a
future breaking release does not silently invalidate the examples.
Install the SDK
Use one client first. You can add the other later if you need it.
uv add "valmar>=1,<2"bun add @valmar-ai/sdk@^1.0.0Set environment variables
VALMAR_BASE_URL is the URL your operator gave you for the customer
deployment.
export VALMAR_API_KEY=valmr_proj_sk_...
export VALMAR_ORGANIZATION_ID=your-org-id
export VALMAR_PROJECT_ID=your-project-id
export VALMAR_BASE_URL=https://valmar.your-company.comWhat you need from the Admin UI
Sign in as org-admin, create a project, add the people Valmar is allowed
to contact, then generate a project credential with the valmr_proj_sk_...
prefix. Keep the organization ID and project ID together with the key —
SDK search is project-scoped.
Next
Continue to Fill the Organization to add people and assign them to your project.