> For the complete documentation index, see [llms.txt](https://gdplabs.gitbook.io/glchat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gdplabs.gitbook.io/glchat/sdk/getting-started.md).

# Getting Started

{% hint style="warning" %}
Before you can make requests to the GLChat API, you must obtain **API Key**. You can get it from the Admin Dashboard, by contacting us via [hi\[at\]glair.ai](mailto:hi@glair.ai), or via our representative for your company.
{% endhint %}

<a href="https://github.com/gdplabs/glchat-sdk-cookbook/tree/main/glchat/examples/hello-world" class="button primary" data-icon="github">View full project code on GitHub</a>

## GLChat SDK

You can send message programmatically using GLChat SDK.

{% tabs %}
{% tab title="Python" %}
Install

```bash
pip install glchat-sdk
```

Set API Key

```bash
export GLCHAT_API_KEY=...
```

Make your first API call

{% code lineNumbers="true" %}

```python
from glchat_sdk import GLChat

client = GLChat()
response = client.message.create(
    chatbot_id="no-op",
    message="Hello!"
)

for chunk in response:
    print(chunk.decode("utf-8"), end="")
```

{% endcode %}

The response will be a streaming Server-Sent Event (SSE) so you can display parts of the response as they become available. This is a sample of the streaming response:

{% code lineNumbers="true" %}

```json
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502862, "status": "response", "message": "Hello"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502873, "status": "response", "message": "Hello!"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502884, "status": "response", "message": "Hello! How"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502894, "status": "response", "message": "Hello! How can"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502913, "status": "response", "message": "Hello! How can I"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502924, "status": "response", "message": "Hello! How can I assist"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502969, "status": "response", "message": "Hello! How can I assist you"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502980, "status": "response", "message": "Hello! How can I assist you today"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502991, "status": "response", "message": "Hello! How can I assist you today?"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403503002, "status": "response", "message": "Hello! How can I assist you today?\n"}
```

{% endcode %}

More details on [PyPI glchat-sdk](https://pypi.org/project/glchat-sdk/).
{% endtab %}

{% tab title="JavaScript" %}
Install

```bash
npm install glchat-sdk
```

Set API Key

```bash
export GLCHAT_API_KEY=...
```

Make your first API call

{% code lineNumbers="true" %}

```javascript
import { GLChat } from "glchat-sdk";

const client = new GLChat();

void (async () => {
  const result = await client.message.create({
    chatbot_id: "no-op",
    message: "Hello!",
    stream: false
  });

  for await (const chunk of result) {
    console.log(chunk);
  }
})();
```

{% endcode %}

The response will be a streaming Server-Sent Event (SSE) so you can display parts of the response as they become available. This is a sample of the streaming response:

{% code lineNumbers="true" %}

```json
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502862, "status": "response", "message": "Hello"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502873, "status": "response", "message": "Hello!"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502884, "status": "response", "message": "Hello! How"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502894, "status": "response", "message": "Hello! How can"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502913, "status": "response", "message": "Hello! How can I"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502924, "status": "response", "message": "Hello! How can I assist"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502969, "status": "response", "message": "Hello! How can I assist you"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502980, "status": "response", "message": "Hello! How can I assist you today"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502991, "status": "response", "message": "Hello! How can I assist you today?"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403503002, "status": "response", "message": "Hello! How can I assist you today?\n"}
```

{% endcode %}

More details on [NPM glchat-sdk](https://www.npmjs.com/package/glchat-sdk).
{% endtab %}

{% tab title="cURL" %}
{% code lineNumbers="true" %}

```bash
curl -X POST 'https://glchat-api.foobar.com/message' \
-H 'Authorization: Bearer '$GLCHAT_API_KEY'' \
-F 'chatbot_id=no-op' \
-F 'message=Hello!'
```

{% endcode %}

The response will be a streaming Server-Sent Event (SSE) so you can display parts of the response as they become available. This is a sample of the streaming response:

{% code lineNumbers="true" %}

```json
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502862, "status": "response", "message": "Hello"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502873, "status": "response", "message": "Hello!"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502884, "status": "response", "message": "Hello! How"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502894, "status": "response", "message": "Hello! How can"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502913, "status": "response", "message": "Hello! How can I"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502924, "status": "response", "message": "Hello! How can I assist"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502969, "status": "response", "message": "Hello! How can I assist you"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502980, "status": "response", "message": "Hello! How can I assist you today"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403502991, "status": "response", "message": "Hello! How can I assist you today?"}
data:{"conversation_id": null, "user_message_id": null, "assistant_message_id": null, "created_date": 1750403503002, "status": "response", "message": "Hello! How can I assist you today?\n"}
```

{% endcode %}
{% endtab %}
{% endtabs %}

For more advanced usages, see [How-To Guides](/glchat/sdk/how-to-guides.md).