{"id":21525,"library":"lightning-cloud","title":"Lightning Cloud","description":"A Python library for managing and deploying models on the Lightning AI cloud platform. Current version 0.6.0. Release cadence is irregular, tied to platform updates.","status":"active","version":"0.6.0","language":"python","source_language":"en","source_url":"https://github.com/Lightning-AI/lightning-cloud","tags":["lightning","cloud","deployment","mlops"],"install":[{"cmd":"pip install lightning-cloud","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core Lightning framework often used together","package":"lightning","optional":true}],"imports":[{"note":"Lightning Cloud uses underscore in module name","wrong":"from lightning.cloud import LightningClient","symbol":"LightningClient","correct":"from lightning_cloud import LightningClient"},{"note":"","wrong":"","symbol":"AuthHandler","correct":"from lightning_cloud.auth import AuthHandler"}],"quickstart":{"code":"from lightning_cloud import LightningClient\n\nclient = LightningClient()\n# Use client to interact with Lightning AI cloud\n# Example: list projects\nprojects = client.get_projects()\nprint(projects)","lang":"python","description":"Initialize LightningClient and fetch projects"},"warnings":[{"fix":"Pin to a specific version and test thoroughly before upgrading.","message":"Lightning Cloud API is in early development; endpoints and signatures change frequently without deprecation.","severity":"breaking","affected_versions":"all <1.0"},{"fix":"Use 'from lightning_cloud import ...'","message":"The top-level import 'from lightning import cloud' does not work; you must import from 'lightning_cloud' directly.","severity":"gotcha","affected_versions":"all"},{"fix":"Set LIGHTNING_API_KEY environment variable or pass api_key parameter to client.","message":"LightningClient may require authentication via environment variable LIGHTNING_API_KEY; if not set, some methods will fail with authentication errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install lightning-cloud only: pip install lightning-cloud. Do not install 'lightning' unless needed.","cause":"Trying to import 'lightning.cloud' without having 'lightning' installed.","error":"ModuleNotFoundError: No module named 'lightning'"},{"fix":"Upgrade to latest version: pip install --upgrade lightning-cloud","cause":"Older versions of lightning-cloud may not have LightningClient at the top-level.","error":"ImportError: cannot import name 'LightningClient' from 'lightning_cloud'"},{"fix":"Set LIGHTNING_API_KEY environment variable or pass api_key='your_key' to LightningClient.","cause":"No API key or invalid API key provided.","error":"requests.exceptions.HTTPError: 401 Client Error: Unauthorized"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}