Quickstart

Make your first search call in a few minutes.

Get an API key. There’s no public dashboard yet — contact the Telem team for an API key. Some Telem deployments run open and don’t require one at all; see Authentication for details.
Install the SDK.
Terminal window
```
pip install telem-sdk
```
Make a search call. The SDK reads TELEM_API_KEY and TELEM_BASE_URL from the environment, or you can call the API directly with curl. Either way, export both first — the curl form has no default to fall back on, so an unset TELEM_BASE_URL fails with curl: (3) URL rejected:
Terminal window
```
export TELEM_BASE_URL=https://router.telem.ai   # or your own deployment
export TELEM_API_KEY=...                        # your key
```
- Python
- curl
from telem import Telem client = Telem() # reads TELEM_API_KEY / TELEM_BASE_URL from env response = client.search("when was the International Space Station launched") print(response.results[0].title)
Terminal window
# TELEM_API_KEY is optional: some Telem deployments run open and accept # unauthenticated requests, so the Authorization header is only added when a # key is actually set (an empty "Bearer " header would make an otherwise-open # deployment reject the request). auth_header=() if [ -n "${TELEM_API_KEY:-}" ]; then auth_header=(-H "Authorization: Bearer $TELEM_API_KEY") fi curl -s -X POST "$TELEM_BASE_URL/v1/interactions" \ "${auth_header[@]}" \ -H "Content-Type: application/json" \ -d '{"user_input": {"query": "when was the International Space Station launched"}, "postprocessor_names": [], "metadata": {}}'
Check the output. The Python sample prints the top result’s title — for this query, International Space Station; the curl call returns the full POST /v1/interactions response as JSON.

Install for your agent instead

Prefer to wire Telem straight into your coding agent rather than call the SDK yourself? Pick your surface: