valmar 0.1.0

Python SDK for the Valmar platform

valmar

Python SDK for the Valmar platform.

Documentation: https://docs.getvalmar.com

Source: https://github.com/TheValmarAI/valmar-python

License: Apache-2.0

Installation

uv add valmar

Quick start

from valmar import Valmar

client = Valmar(
    api_key="valmr_proj_sk_...",
    base_url="https://your-valmar-deployment.example.com",
    organization_id="your-org-id",
    project_id="your-project-id",
)

base_url is required because Valmar is deployed per customer. Use the base URL for your own Valmar deployment.

Search knowledge

Find relevant saved knowledge across the configured project.

results = client.knowledge.search("deployment process")

for item in results.items:
    print(f"{item.title} ({item.confidence})")
    print(item.content_md)

Create a knowledge request

Create a knowledge request that gets routed to the right people in your organization.

handle = client.knowledge_requests.create(
    "How do we handle database migrations in production?",
    background_context="Planning a schema change for the orders table",
)

print(f"Request created: {handle.knowledge_request_id}")
print(f"Status: {handle.status}")

request = client.knowledge_requests.get(handle.knowledge_request_id)
if request.status == "completed":
    print(request.result_summary)

List and import people

from valmar import CreatePersonInput

people = client.people.list()

result = client.people.import_bulk(
    [
        CreatePersonInput(
            email="[e-mail]",
            display_name="Ada Lovelace",
            timezone="UTC",
            title="Principal Engineer",
        )
    ]
)

Context manager

with Valmar(
    api_key="valmr_proj_sk_...",
    base_url="https://your-valmar-deployment.example.com",
    organization_id="your-org-id",
    project_id="your-project-id",
) as client:
    results = client.knowledge.search("onboarding process")

Error handling

The SDK raises httpx.HTTPStatusError for non-2xx responses.

import httpx

try:
    client.knowledge.search("test")
except httpx.HTTPStatusError as e:
    print(f"API error {e.response.status_code}: {e.response.text}")