{"id":28166,"library":"scaleway-core","title":"Scaleway SDK for Python","description":"Official Python SDK for Scaleway cloud infrastructure. Provides client libraries for managing Scaleway resources (instances, Kubernetes, databases, etc.). Currently at version 2.11.0, with monthly releases.","status":"active","version":"2.11.0","language":"python","source_language":"en","source_url":"https://github.com/scaleway/scaleway-sdk-python","tags":["scaleway","cloud","sdk","api","infrastructure"],"install":[{"cmd":"pip install scaleway-core","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"In SDK v2, the Client class is imported from the top-level 'scaleway' package, not from 'scaleway_core'.","wrong":"from scaleway_core import Client","symbol":"Client","correct":"from scaleway import Client"},{"note":"Exceptions are re-exported from the top-level package.","wrong":"from scaleway_core.exceptions import ScalewayException","symbol":"ScalewayException","correct":"from scaleway import ScalewayException"}],"quickstart":{"code":"from scaleway import Client\nfrom scaleway.instance.v1 import InstanceAPI\n\n# Initialize client (uses SCW_ACCESS_KEY, SCW_SECRET_KEY, SCW_DEFAULT_PROJECT_ID env vars)\nclient = Client.from_env()\n\napi = InstanceAPI(client)\n\n# List instances\nservers = api.list_servers().servers\nfor server in servers:\n    print(server.name, server.state)","lang":"python","description":"Initialize the SDK using environment variables and list all instances."},"warnings":[{"fix":"Use 'from scaleway import Client' and 'from scaleway.{service}.{version} import {ServiceAPI}' patterns. See migration guide: https://github.com/scaleway/scaleway-sdk-python/blob/main/MIGRATION.md","message":"SDK v2 (scaleway-core) is a complete rewrite from v1 (scaleway-sdk). Import paths, client initialization, and API classes have changed significantly.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Always check the Scaleway API documentation for the latest version. For example, instance API is at 'instance.v1'.","message":"API classes are versioned (e.g., instance.v1, k8s.v1). Using the wrong version may lead to missing methods or different response structures.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Set environment variables or use 'Client(access_key=..., secret_key=..., default_project_id=...)' explicitly.","message":"Environment variables SCW_ACCESS_KEY and SCW_SECRET_KEY are required. If not set, Client.from_env() will raise a ConfigurationError.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Adjust per_page and max_pages parameters in list methods, or iterate over pages manually using the pagination API.","message":"Pagination is handled automatically by default (per_page=100, max_pages=5). Large lists may be truncated.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Uninstall old SDK and install 'scaleway-core': pip uninstall scaleway-sdk && pip install scaleway-core","cause":"Installing 'scaleway-core' does not create a top-level module named 'scaleway'? Actually, it does. But users may have installed 'scaleway-sdk' (v1) instead.","error":"ModuleNotFoundError: No module named 'scaleway'"},{"fix":"Ensure scaleway-core >=2.0.0: pip install --upgrade scaleway-core","cause":"You may have an older version of scaleway-core installed, or you are importing from 'scaleway_core' directly. In v2, the Client is exported at 'scaleway.Client'.","error":"AttributeError: module 'scaleway' has no attribute 'Client'"},{"fix":"Set environment variables or pass credentials explicitly: Client(access_key='...', secret_key='...', default_project_id='...')","cause":"Client.from_env() requires SCW_ACCESS_KEY, SCW_SECRET_KEY, and SCW_DEFAULT_PROJECT_ID to be set.","error":"scaleway.core.exceptions.ConfigurationError: Missing mandatory environment variables: SCW_ACCESS_KEY"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}