{"library":"spaces","title":"Hugging Face Spaces Utilities (Legacy)","type":"library","description":"The `spaces` library (version 0.48.2) provides utilities for interacting with Hugging Face Spaces. It largely acts as a thin wrapper around the `huggingface_hub` library, which provides the core API for managing Spaces. As of late 2023, its development appears stalled, with most new Spaces features and ongoing maintenance occurring directly within `huggingface_hub`.","language":"python","status":"maintenance","last_verified":"Sat May 16","install":{"commands":["pip install spaces"],"cli":null},"imports":["from spaces import HfApi"],"auth":{"required":false,"env_vars":[]},"links":{"homepage":"https://huggingface.co","github":"https://github.com/huggingface/huggingface_hub","docs":null,"changelog":null,"pypi":"https://pypi.org/project/spaces/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null},"quickstart":{"code":"import os\nfrom spaces import HfApi\n\n# Authenticate using an environment variable\nHF_TOKEN = os.environ.get(\"HF_TOKEN\", \"hf_YOUR_TOKEN_HERE\")\n\nif HF_TOKEN == \"hf_YOUR_TOKEN_HERE\":\n    print(\"Please set the HF_TOKEN environment variable for authentication.\")\n    print(\"You can get one from https://huggingface.co/settings/tokens\")\n    exit(1)\n\napi = HfApi(token=HF_TOKEN)\n\ntry:\n    # This example lists spaces owned by the authenticated user\n    # Note: For new features and active development, prefer 'huggingface_hub' directly.\n    user_info = api.whoami()\n    if user_info and 'name' in user_info:\n        my_spaces = api.list_spaces(author=user_info['name'])\n        print(f\"Found {len(my_spaces)} spaces for user '{user_info['name']}':\")\n        for space in my_spaces:\n            print(f\"- {space.id} (Status: {space.runtime['stage']})\")\n    else:\n        print(\"Could not retrieve user info. Check your token's permissions.\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Ensure your HF_TOKEN is valid and has appropriate permissions.\")\n","lang":"python","description":"Demonstrates how to initialize the Hugging Face API client using the `spaces` library and list your Hugging Face Spaces. It highlights the use of an `HF_TOKEN` for authentication.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"0.46.0","pypi_latest":"0.50.2","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":90,"avg_install_s":18.3,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"293.4M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":18.1,"import_time_s":null,"mem_mb":null,"disk_size":"287M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"316.1M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":16.5,"import_time_s":null,"mem_mb":null,"disk_size":"309M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"299.7M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15.2,"import_time_s":null,"mem_mb":null,"disk_size":"293M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"299.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15.3,"import_time_s":null,"mem_mb":null,"disk_size":"292M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"spaces","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"spaces","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":26.6,"import_time_s":null,"mem_mb":null,"disk_size":"361M"}]}}