Install & Compatibility
Where this runs
tested against v1.124.3 · 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
muslpy 3.10–3.940 runs
installs and imports cleanly · install 0.0s · import 0.015s · 38MB
glibcpy 3.10–3.940 runs
installs and imports cleanly · install 3.5s · import 0.014s · 38MB
40MB installed
● package 40MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
launchable
✓ import launchable
✗ import subprocess
This quickstart demonstrates how to verify your Launchable CLI installation and authentication using Python's `subprocess` module, which is the recommended way for programmatic interaction with the CLI. It assumes the `LAUNCHABLE_TOKEN` environment variable is set for authentication.
import os
import subprocess
# Replace with your actual Launchable API key or retrieve from environment
# For CI/CD, this is typically set as an environment variable (e.g., LAUNCHABLE_TOKEN)
api_key = os.environ.get('LAUNCHABLE_TOKEN', 'YOUR_LAUNCHABLE_API_KEY')
if not api_key or api_key == 'YOUR_LAUNCHABLE_API_KEY':
print("Warning: LAUNCHABLE_TOKEN environment variable not set. Using placeholder.")
print("Please set LAUNCHABLE_TOKEN for actual usage.")
# For demonstration, we'll proceed, but real usage requires a valid token
os.environ['LAUNCHABLE_TOKEN'] = api_key
try:
print("Verifying Launchable CLI configuration...")
result = subprocess.run(['launchable', 'verify'], capture_output=True, text=True, check=True)
print("Launchable CLI verification successful:")
print(result.stdout)
except subprocess.CalledProcessError as e:
print(f"Error verifying Launchable CLI: {e.stderr}")
print("Please ensure LAUNCHABLE_TOKEN is set correctly and Java 8+ is installed.")
except FileNotFoundError:
print("Error: 'launchable' command not found.")
print("Please ensure the Launchable CLI is installed and in your system's PATH.")
launchable --version
Debug
Known issues
breakingMajor version updates (e.g., from `1.x` to `2.x`) are explicitly stated to introduce drastic changes that break backward compatibility. Pin your dependency to `launchable~=1.0` for stability within the 1.x release line.fixUse `pip install launchable~=1.0` to constrain installations to the current major version. Review changelogs for migration guides before upgrading major versions.
affects: 1.x to 2.x (future major versions)
gotchaThe Launchable CLI requires a Java Runtime Environment (JRE) version 8 or newer to be installed and accessible in the system's PATH, even though the CLI itself is a Python package. This is a common oversight for Python-only environments.fixInstall Java 8 (or a newer compatible version) and ensure its `bin` directory is included in your system's PATH environment variable.
affects: All versions
gotchaAuthentication to the Launchable platform primarily relies on the `LAUNCHABLE_TOKEN` environment variable. If this is not set or is incorrect, CLI commands will fail with authentication errors. For open-source projects, tokenless authentication via GitHub OIDC requires specific GitHub Actions YAML configuration.fixSet the `LAUNCHABLE_TOKEN` environment variable with your API key. For CI/CD, use secret management features of your CI system. For open-source projects, refer to the documentation on 'tokenless authentication'.
affects: All versions
Upgrade
Version history
1.124.3latest on PyPI · released Jun 15, 2026
Audit
Dependencies
PythonrequiredRuntime environment for the CLI.
JavarequiredRequired runtime for underlying components of the CLI.