{"id":2860,"library":"alibabacloud-tea","title":"Alibaba Cloud Tea for Python","description":"Alibaba Cloud Tea for Python is the core `tea` module of the Alibaba Cloud Python SDK ecosystem. It acts as a low-level library primarily designed to support Darabonba OpenAPI DSL, facilitating HTTP requests and foundational utilities for other higher-level Alibaba Cloud SDKs. Its current version is 0.4.3, and it receives frequent updates, often tied to releases of dependent SDK components.","status":"active","version":"0.4.3","language":"python","source_language":"en","source_url":"https://github.com/aliyun/tea-python","tags":["cloud","alibaba","sdk","utility","http","openapi"],"install":[{"cmd":"pip install alibabacloud-tea","lang":"bash","label":"Install alibabacloud-tea"}],"dependencies":[],"imports":[{"symbol":"TeaModel","correct":"from Tea.model import TeaModel"},{"symbol":"TeaCore","correct":"from Tea.core import TeaCore"},{"note":"TeaException is part of the 'exceptions' submodule, not directly under 'Tea'.","wrong":"from Tea import TeaException","symbol":"TeaException","correct":"from Tea.exceptions import TeaException"},{"symbol":"TeaUnretryableException","correct":"from Tea.exceptions import TeaUnretryableException"}],"quickstart":{"code":"import os\nfrom Tea.model import TeaModel\nfrom Tea.exceptions import TeaException\n\nclass MyRequest(TeaModel):\n    def __init__(self, **kwargs):\n        super().__init__(**kwargs)\n        self.my_param = kwargs.get('my_param', None)\n\n    def validate(self):\n        # Example validation: my_param is required\n        if self.my_param is None:\n            raise TeaException({'code': 'MissingParameter', 'message': 'my_param is required'})\n\n\ndef main():\n    print(\"Demonstrating TeaModel and TeaException...\")\n    try:\n        # Valid request\n        req1 = MyRequest(my_param='test_value')\n        req1.validate()\n        print(f\"Request 1 (valid): {req1.my_param}\")\n\n        # Invalid request (missing my_param)\n        req2 = MyRequest()\n        req2.validate()\n\n    except TeaException as e:\n        print(f\"Caught TeaException: Code={e.code}, Message={e.message}\")\n    except Exception as e:\n        print(f\"Caught unexpected exception: {e}\")\n\nif __name__ == '__main__':\n    main()","lang":"python","description":"This quickstart demonstrates the basic usage of `TeaModel` for defining structured request/response objects and `TeaException` for handling errors. `alibabacloud-tea` itself is a foundational library; most direct interaction occurs through other Alibaba Cloud SDKs built upon it."},"warnings":[{"fix":"Upgrade your Python environment to 3.7 or newer. Ensure your `pip` is also up-to-date (`pip install --upgrade pip setuptools`).","message":"Starting from version 0.4.0, `alibabacloud-tea` requires Python 3.7 or higher. Older Python versions will not be supported.","severity":"breaking","affected_versions":">=0.4.0"},{"fix":"First, update `pip` and `setuptools`: `pip install --upgrade pip setuptools`. Then, ensure you install the correct package: `pip install alibabacloud-tea`.","message":"Encountering `ModuleNotFoundError: No module named 'Tea'` typically indicates an outdated `pip` version or an incorrect package installation. Users might mistakenly install a package named `tea` instead of `alibabacloud-tea`.","severity":"gotcha","affected_versions":"All"},{"fix":"Implement explicit `try...except TeaException` and `try...except TeaUnretryableException` blocks around SDK calls. Consult the specific SDK's documentation for common error codes.","message":"When using Alibaba Cloud SDKs that rely on `alibabacloud-tea`, always handle `TeaException` and `TeaUnretryableException` for robust error management, differentiating between business logic errors and network issues.","severity":"gotcha","affected_versions":"All"},{"fix":"Configure credentials using environment variables (`ALIBABA_CLOUD_ACCESS_KEY_ID`, `ALIBABA_CLOUD_ACCESS_KEY_SECRET`) or Alibaba Cloud Resource Access Management (RAM) roles and credentials providers.","message":"Avoid hardcoding Alibaba Cloud AccessKey ID and Secret. This is a security risk and generally not recommended for production environments.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-05-21T05:04:28.361Z","next_check":"2026-07-10T00:00:00.000Z","problems":[{"fix":"Install the package using pip: 'pip install alibabacloud-tea'.","cause":"The 'alibabacloud-tea' package is not installed or not properly installed.","error":"ModuleNotFoundError: No module named 'alibabacloud-tea'"},{"fix":"Ensure pip is up-to-date and reinstall the package: 'pip install --upgrade pip' followed by 'pip install alibabacloud-tea'.","cause":"The 'Tea' module, part of the 'alibabacloud-tea' package, is missing due to an incomplete or failed installation.","error":"ModuleNotFoundError: No module named 'Tea'"},{"fix":"Update the 'alibabacloud_credentials' package to the latest version: 'pip install --upgrade alibabacloud_credentials'.","cause":"The 'alibabacloud_credentials' package is outdated, leading to incompatibility issues.","error":"AttributeError: 'CredentialModel' object has no attribute 'provider_name'"},{"fix":"Upgrade Python to version 3.7 or higher and ensure pip is updated: 'pip install --upgrade pip'.","cause":"An outdated Python or pip version, or missing development libraries, causes the installation to fail.","error":"Command 'python setup.py egg_info' failed with error code 1 in /path/to/package"},{"fix":"Verify that the service is available in the specified region and adjust the region parameter accordingly.","cause":"The specified region does not support the service being called.","error":"Tea.exceptions.UnretryableException"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.4.3","cli_name":"","cli_version":null,"type":"library","homepage":"https://www.aliyun.com/","github":"https://github.com/aliyun/tea-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/alibabacloud-tea/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","aws"],"install_checks":{"last_tested":"2026-05-21","tag":null,"tag_description":null,"installed_version":"0.4.3","pypi_latest":"0.4.3","is_stale":false,"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"31.2M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"31.4M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":5.5,"import_time_s":0,"mem_mb":0,"disk_size":"33M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"34M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"34.6M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"34.9M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":4.5,"import_time_s":0,"mem_mb":0,"disk_size":"37M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"37M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"24.5M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"24.8M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":4.8,"import_time_s":0,"mem_mb":0,"disk_size":"27M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"27M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0,"mem_mb":0.2,"disk_size":"23.9M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0.2,"disk_size":"24.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":4.5,"import_time_s":0,"mem_mb":0,"disk_size":"26M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"26M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"31.4M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"31.4M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":6.5,"import_time_s":0,"mem_mb":0,"disk_size":"34M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"alibabacloud-tea","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0,"mem_mb":0,"disk_size":"34M"}]},"quickstart_checks":{"last_tested":"2026-04-25","tag":null,"tag_description":null,"results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":0},{"runtime":"python:3.11-alpine","exit_code":0},{"runtime":"python:3.11-slim","exit_code":0},{"runtime":"python:3.12-alpine","exit_code":0},{"runtime":"python:3.12-slim","exit_code":0},{"runtime":"python:3.13-alpine","exit_code":0},{"runtime":"python:3.13-slim","exit_code":0},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":0}]},"_links":{"self":"https://checklist.day/api/registry/alibabacloud-tea","v1":"https://checklist.day/v1/registry/alibabacloud-tea","v1_install":"https://checklist.day/v1/registry/alibabacloud-tea/install","v1_imports":"https://checklist.day/v1/registry/alibabacloud-tea/imports","v1_compatibility":"https://checklist.day/v1/registry/alibabacloud-tea/compatibility","v1_quickstart":"https://checklist.day/v1/registry/alibabacloud-tea/quickstart","docs":"https://checklist.day/docs"}}