Changelog

Published versions of the Komodo Python SDK are distributed as the komodo package on PyPI. The CLI reports the installed package version via komodo --version.

PyPI

Install or pin a version with:

pip install komodo==<version>
# or
uv add komodo==<version>

The komodo package on PyPI lists published versions and metadata.

When upgrading, review PyPI release notes or your internal release communications for breaking changes, new CLI commands, and MCP behavior.

Notable changes

Marmot chat from the CLI and SDK

• komodo marmot -c "<message>" now chats through Marmot’s Analysis API: each chat creates an analysis with a conversation in it, renders the reply in the terminal, and — in an interactive terminal — keeps the session open for follow-up messages in the same analysis (Ctrl+C to end). See the CLI reference.
• New MarmotApi SDK client (client.marmot) for driving Marmot programmatically: create analyses and conversations, send messages, wait for replies, and read the analysis’s files (list_files / get_file). See the SDK reference.

Query error visibility and diagnostics

• Failed queries now surface the full Snowflake error — message, error code, SQL state, and query ID — instead of a generic message. Legitimate SQL errors that mention words like “key” or “token” are no longer blanked out.
• New get_query_diagnostics(connection, query_id) SDK helper and komodo sql-diagnostics <query-id> CLI command return the error code/message, execution status, warehouse, and timing Snowflake recorded for a query, so you can self-diagnose failures. See Inspecting failures and Troubleshooting.