Marmot Development Kit

The komodo PyPI package is the Python SDK and CLI component of the Marmot Development Kit for the Komodo Health platform. It ships three main surfaces:

Surface	What you get
SDK	Python APIs for OAuth-backed sessions, account context, Snowflake access via a DB-API 2.0 connection, and the Marmot Analysis API (`client.marmot`)
CLI	The `komodo` command-line tool for login, account selection, ad hoc SQL, chatting with Marmot (`komodo marmot -c`), running the MCP server, and more
MCP tools	A Model Context Protocol server you can attach to compatible AI clients so assistants can call Komodo-backed tools (see the docs for configuration)

Together they cover authentication, querying your Komodo data warehouse, and optional assistant-driven workflows.

Features

OAuth 2.0 device flow — browser-based login and persisted credentials
Snowflake access — query your warehouse through the platform proxy (SDK or CLI)
Sync and async queries — blocking execution and async submit/poll helpers in Python
Marmot chat — create Marmot analyses and chat from the terminal (komodo marmot -c, interactive) or from Python (client.marmot), and read the files an analysis produces (requires a Marmot subscription)
Automatic token refresh
Environments — integration or production via KOMODO_ENVIRONMENT

Prerequisites

Python 3.11 or higher (see requires-python in this package)
uv (recommended)

Installation

From a new directory, initialize a uv project and add the package:

uv init
uv add komodo

Confirm the CLI:

uv run komodo --version

Quick start

Log in (opens a browser):
```
uv run komodo login
```
Choose your Komodo account:
```
uv run komodo account set
```

Use the SDK from Python — create first_query.py:

from komodo import get_snowflake_connection

conn = get_snowflake_connection()
cursor = conn.cursor()
cursor.execute("SELECT 1")
print(cursor.fetchone())
conn.close()

uv run first_query.py

Documentation

Full guides for the Marmot Development Kit—SDK, CLI, MCP setup, authentication (including machine-to-machine), pandas, and API reference:

https://docs.komodohealth.com

Metadata

Release files for komodo 3.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for komodo 3.4.5
File	Size	Uploaded	Provenance
komodo-3.4.5.tar.gz	223.3 kB	Oct 27, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for komodo 3.4.5
File	Interpreter	ABI	Platform	Reset
komodo-3.4.5-py3-none-any.whl 274.9 kB Oct 27, 2026 Without provenance	Python 3	none	any	Details

Total release size: 498.2 kB

Release files / komodo-3.4.5.tar.gz

Download URL	komodo-3.4.5.tar.gz
Size	223.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`5c44118dd30230ecebae8978b760a2183c001868ea895e32ff83cdc2a8b312b2`
BLAKE2b-256 checksum How to use checksums	`368c815d92848533dd1375bb3570b6feed32dc8398a154e49080e07c98f8c34d`
Upload date	Oct 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / komodo-3.4.5-py3-none-any.whl

Download URL	komodo-3.4.5-py3-none-any.whl
Size	274.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7ecd89419d1f497a67d70e25ca3f48a9b4785063dbf602939a4095c84952780d`
BLAKE2b-256 checksum How to use checksums	`e3499cc38c154c380707fc997f0881a6440749a2d7d40f9c1e1c95d5f0f814fb`
Upload date	Oct 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Security for komodo 3.4.5

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.