Registry / devops / snowflake-cli-labs

snowflake-cli-labs

JSON →
library3.20.0pypypiunverified

The `snowflake-cli-labs` package provides the official Snowflake Command Line Interface (CLI), a powerful tool for interacting with Snowflake accounts, managing objects, and deploying applications like Snowpark Container Services or Streamlit apps. It's developed by Snowflake-Labs, with version 3.16.0 currently active. Releases typically align with Snowflake platform updates and feature developments.

devopsdatabase
pip install snowflake-cli-labs
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · SNOWFLAKE-CLI-LABS
S
snowflake-cli-labs
devopspythonv3.20.0
Install
15.8s avg
Import
—
Disk
171MB
Pass rate
5/ 10
Env Coverage5 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v3.20.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.910 runs
build_error
glibc
py 3.10–3.910 runs
installs and imports cleanly · install 15.8s · import 0.000s · 179MB
171MB installed
● package 171MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

app
✓ from snowcli.cli_app import app
✗ from snowflake_cli_labs import app
The `snowflake-cli-labs` package is primarily a command-line interface tool, exposing the `snow` command. Direct programmatic import of its components is uncommon for general use. For advanced scenarios (e.g., testing or building custom commands/extensions), the internal Python module is `snowcli`.

The Snowflake CLI is primarily used via the `snow` command in your terminal. This quickstart demonstrates verifying installation, configuring a connection, and running a basic SQL query.

# 1. Verify installation and see available commands snow --help # 2. Add a new connection profile (replace with your details) # This will prompt for your Snowflake account URL, username, and password. # The 'default' profile is used if no other is specified. snow connection add --name default # 3. List existing connection profiles snow connection list # 4. Run a simple SQL query snow sql -q "SELECT current_version();"
snow --version
Debug
Known issues
breakingThe `snowflake-cli-labs` package is the official successor to the older, standalone `snowcli` (pre-v1.0). Users of the legacy `snowcli` must migrate, as commands, configurations, and functionalities may differ significantly.
fix
Uninstall the old `snowcli` if present, then `pip install snowflake-cli-labs`. Review the migration guide for specific command changes and `project.toml` schema updates.
affects: < 1.0 (legacy snowcli)
gotchaConnection authentication methods and profile management can be a common source of issues. The CLI supports browser-based, username/password, and key-pair authentication, each with specific setup requirements.
fix
Use `snow connection add --help` to understand available options. Ensure your account locator, username, and authentication method (e.g., browser popup, `SNOWFLAKE_PASSWORD` environment variable, or key file path) are correctly configured for your chosen profile.
affects: All versions
breakingThe schema for `project.toml` files, used for deploying Snowpark applications, Streamlit apps, or other Snowflake objects, can change between major CLI versions. This may require manual updates to your project definitions.
fix
Always refer to the official Snowflake CLI documentation for the current `project.toml` schema when upgrading your CLI or migrating existing projects. You may need to update section names, properties, or file paths.
affects: All major versions (e.g., 2.x to 3.x)
Upgrade
Version history
3.20.0latest on PyPI · released Jun 8, 2026
Audit
Dependencies
pythonrequiredRequires Python 3.10 or newer.
Agent activity
17 hits · last 30 days
node
14
Resources
githubhttps://github.com/snowflakedb/snowflake-cli ↗
packagehttps://pypi.org/project/snowflake-cli-labs/ ↗
homepagehttps://docs.snowflake.com/en/developer-guide/snowflake-cli-v2/index ↗
snowflake-cli-labs — pip install snowflake-cli-labs · libregistry