> ## Documentation Index
> Fetch the complete documentation index at: https://kumo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# kumoai

> Root module — initialization, logging, and core type enumerations

The `kumoai` root module provides SDK initialization, logging configuration, and the core type enumerations (`Dtype`, `Stype`) used throughout the SDK.

***

## `init()`

Initializes and authenticates the SDK against the Kumo service. Must be called before using any other SDK functionality.

```python theme={null}
import kumoai

kumoai.init(url="<api_url>", api_key="<api_key>")
```

<ParamField body="url" type="str" default="None">
  The Kumo API endpoint. Can also be provided via the `KUMO_API_ENDPOINT` environment variable. Inferred from the API key if not specified.
</ParamField>

<ParamField body="api_key" type="str" default="None">
  The Kumo API key. Can also be provided via the `KUMO_API_KEY` environment variable.
</ParamField>

<ParamField body="snowflake_credentials" type="Dict[str, str]" default="None">
  Snowflake credentials for SPCS deployments. Either password-based `{"user", "password", "account"}` or key-pair `{"user", "private_key", "account"}` with optional `"private_key_passphrase"` for encrypted keys. The private key must be in PEM format.
</ParamField>

<ParamField body="snowflake_application" type="str" default="None">
  The Snowflake application name.
</ParamField>

<ParamField body="log_level" type="str" default="&#x22;INFO&#x22;">
  Logging verbosity. See [`set_log_level()`](#set-log-level) for valid values. Can also be set via the `KUMOAI_LOG` environment variable.
</ParamField>

<ParamField body="group" type="str" default="None">
  The group to operate in. Only applicable when RBAC is enabled. Accepts a group name or ID. Auto-selected if the user belongs to exactly one group.
</ParamField>

<ParamField body="project" type="str" default="None">
  The project to operate in. Only applicable when RBAC is enabled. Requires `group` to be resolvable.
</ParamField>

***

## `set_log_level()`

Sets the logging verbosity for the Kumo SDK.

```python theme={null}
kumoai.set_log_level("DEBUG")
```

<ParamField body="level" type="str" required>
  The logging level. Valid values from most to least verbose: DEBUG, INFO, WARNING, ERROR, CRITICAL (`FATAL` is an alias for `CRITICAL`).
</ParamField>

***

## `Dtype`

Enumerates the data types supported by Kumo columns.

| Value         | Description                           |
| ------------- | ------------------------------------- |
| `bool`        | Boolean column                        |
| `int`         | Integer column                        |
| `byte`        | 8-bit integer column                  |
| `int16`       | 16-bit integer column                 |
| `int32`       | 32-bit integer column                 |
| `int64`       | 64-bit integer column                 |
| `float`       | Floating-point column                 |
| `float32`     | 32-bit float column                   |
| `float64`     | 64-bit float column                   |
| `string`      | String column                         |
| `binary`      | Binary column                         |
| `date`        | Date column                           |
| `time`        | Time column                           |
| `timedelta`   | Timedelta column                      |
| `floatlist`   | List of floats (sequence / embedding) |
| `intlist`     | List of integers                      |
| `stringlist`  | List of strings                       |
| `unsupported` | Unsupported type                      |

***

## `Stype`

Enumerates the semantic types supported by Kumo columns. Semantic types describe how Kumo interprets and encodes the data in a column.

| Value              | Description                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------- |
| `numerical`        | A numerical column. Typically integers or floats.                                                       |
| `categorical`      | A categorical column. Typically a boolean or short string value.                                        |
| `multicategorical` | A multi-categorical column. Typically a string containing multiple concatenated category labels.        |
| `ID`               | A column holding entity identifiers.                                                                    |
| `text`             | A text column. Multi-token string values where the language content carries semantic meaning.           |
| `timestamp`        | A date/time column.                                                                                     |
| `sequence`         | A sequence or embedding column. Lists of floats of equal length, typically the output of another model. |
| `image`            | A column holding image URLs.                                                                            |
| `unsupported`      | Unsupported type.                                                                                       |