{"id":777,"library":"llama-cloud-services","title":"Llama Cloud Services SDK (Deprecated)","description":"This library provides tailored SDK clients for LlamaCloud services such as LlamaParse, LlamaExtract, and LlamaCloud Index. As of January 2026, this package is officially deprecated and will only be maintained until May 1, 2026. Users are strongly advised to migrate to the `llama-cloud` Python package for continued support and new features.","status":"deprecated","version":"0.6.94","language":"python","source_language":"en","source_url":"https://github.com/run-llama/llama_cloud_services","tags":["LLM","cloud","LlamaIndex","parsing","extraction","RAG","deprecated"],"install":[{"cmd":"pip install llama-cloud-services","lang":"bash","label":"Install Deprecated Package"},{"cmd":"pip install llama-cloud>=1.0","lang":"bash","label":"Install Recommended Replacement"}],"dependencies":[{"reason":"CLI utilities","package":"click","optional":false},{"reason":"Retry mechanisms","package":"tenacity","optional":false},{"reason":"Data validation and settings management","package":"pydantic","optional":false},{"reason":"Version handling","package":"packaging","optional":false},{"reason":"Platform-specific directory paths","package":"platformdirs","optional":false},{"reason":"Type evaluation backport","package":"eval-type-backport","optional":false},{"reason":"Environment variable management","package":"python-dotenv","optional":true},{"reason":"Core Llama Cloud functionality (likely used internally or for interop)","package":"llama-cloud","optional":false},{"reason":"Core LlamaIndex framework components","package":"llama-index-core","optional":false}],"imports":[{"symbol":"LlamaParse","correct":"from llama_cloud_services import LlamaParse"},{"symbol":"LlamaExtract","correct":"from llama_cloud_services import LlamaExtract"},{"symbol":"LlamaCloudIndex","correct":"from llama_cloud_services import LlamaCloudIndex"},{"note":"Used for connecting to EU SaaS endpoints.","symbol":"EU_BASE_URL","correct":"from llama_cloud_services import EU_BASE_URL"}],"quickstart":{"code":"import os\nfrom llama_cloud_services import LlamaParse\n\n# Get your API key from LlamaCloud. Recommended to use environment variables.\nLLAMA_CLOUD_API_KEY = os.environ.get('LLAMA_CLOUD_API_KEY', 'your_api_key_here')\n\nif LLAMA_CLOUD_API_KEY == 'your_api_key_here':\n    print(\"WARNING: Please set the LLAMA_CLOUD_API_KEY environment variable or replace 'your_api_key_here' with your actual key.\")\n\n# Initialize LlamaParse\nparser = LlamaParse(api_key=LLAMA_CLOUD_API_KEY)\n\n# Example usage (assuming you have a file_id from an uploaded document)\n# This is a conceptual example as parsing a file requires prior upload.\n# For a full workflow, refer to the LlamaCloud documentation.\nprint(\"LlamaParse client initialized. You can now use it to parse documents.\")\n# To parse a document, you would typically upload a file first and then use its ID:\n# job = parser.create(tier=\"agentic\", version=\"latest\", file_id=\"your_uploaded_file_id\")\n# print(f\"Parsing job created with ID: {job.id}\")","lang":"python","description":"This quickstart demonstrates how to initialize the LlamaParse client using the `llama-cloud-services` package. It uses an API key, preferably from an environment variable. Note that to actually parse a document, you would first need to upload a file to LlamaCloud and use its `file_id`."},"warnings":[{"fix":"Migrate to the new `llama-cloud` Python package by installing `pip install llama-cloud>=1.0` and updating your imports and code accordingly. Refer to the official LlamaIndex documentation for migration guides.","message":"The `llama-cloud-services` package is officially deprecated and will no longer be maintained after May 1, 2026. New features and bug fixes will only be released for the new `llama-cloud` package.","severity":"breaking","affected_versions":"<=0.6.94"},{"fix":"For the new `llama-cloud` package, imports are generally from `llama_cloud` (e.g., `from llama_cloud import LlamaCloud`). Services are accessed via the main client object (e.g., `client.parsing.create(...)`). Review the `llama-cloud` documentation for the updated API.","message":"When migrating to the new `llama-cloud` package, import paths and client initialization patterns have changed. Direct replacements of `LlamaParse`, `LlamaExtract`, and `LlamaCloudIndex` from `llama_cloud_services` will not work.","severity":"gotcha","affected_versions":"All versions of llama-cloud-services when migrating to llama-cloud"},{"fix":"Always retrieve your API key from environment variables (e.g., `os.environ.get('LLAMA_CLOUD_API_KEY')`) or a secure secrets management system. The `python-dotenv` package can also be used for local development.","message":"API keys are sensitive. Storing them directly in code is a security risk. The `api_key` parameter is mandatory for client initialization.","severity":"gotcha","affected_versions":"All versions"},{"fix":"If you are using LlamaCloud services in the EU, you must specify `base_url=EU_BASE_URL` during client initialization (e.g., `LlamaParse(api_key=..., base_url=EU_BASE_URL)`). Ensure your API key is also created in the correct region.","message":"LlamaCloud services can be hosted in different regions (e.g., US and EU). The default base URL might not be suitable for all deployments.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Upgrade your Python environment to 3.10 or newer, or downgrade the `llama-index-core` package to a version that is compatible with Python 3.9 (e.g., `<0.14.0`).","message":"The installed `llama-index-core` version uses type hints (`X | Y`) that are incompatible with Python 3.9. This syntax for union types was introduced in Python 3.10 (PEP 604).","severity":"breaking","affected_versions":"llama-index-core>=0.14.0 on Python <3.10"}],"env_vars":null,"last_verified":"2026-05-12T18:57:20.665Z","next_check":"2026-05-01T00:00:00.000Z","problems":[{"fix":"Migrate to the `llama-cloud` package. First, uninstall the old package: `pip uninstall llama-cloud-services`. Then install the new package: `pip install llama-cloud`. Finally, update your import statements, for example, replace `from llama_cloud_services import LlamaParse` with `from llama_cloud import LlamaParse`.","cause":"The `llama-cloud-services` package is deprecated. Users are advised to migrate to the `llama-cloud` package, which has a different top-level module name and structure. This error occurs when old import statements (`from llama_cloud_services import ...`) are used after uninstalling the deprecated package or when the new package is installed.","error":"ModuleNotFoundError: No module named 'llama_cloud_services'"},{"fix":"Ensure you have uninstalled `llama-cloud-services` and installed only `llama-cloud`. Review the `llama-cloud` documentation for the correct class names and import paths, as `ExtractAgentCreate` might have been renamed or moved within the new package structure. If using LlamaExtract, the main class is `LlamaExtract`.","cause":"This error typically occurs when there's a version mismatch or conflict between `llama-cloud-services` and `llama-cloud` packages, or when attempting to import a class that has been renamed or refactored in the newer `llama-cloud` package, leading to an incorrect import path or non-existent name in the `llama_cloud` module.","error":"ImportError: cannot import name 'ExtractAgentCreate' from 'llama_cloud'"},{"fix":"Verify your API key is correct and active in your LlamaCloud dashboard. Ensure it's passed correctly to the client constructor (e.g., `LlamaParse(api_key=\"YOUR_API_KEY\")`) or set as the `LLAMA_CLOUD_API_KEY` environment variable. If using a specific region, confirm the `base_url` parameter matches the region where your API key was generated (e.g., `base_url=\"https://api.cloud.eu.llamaindex.ai\"` for EU).","cause":"This HTTP error indicates an issue with authentication, usually due to an invalid, expired, or incorrectly provided API key, or attempting to use an API key from one region (e.g., North America) with a different regional API endpoint (e.g., EU).","error":"401 Unauthorized on every request"},{"fix":"Check the job status via the API or web UI for more specific error codes or messages. For large or complex documents, consider optimizing by using `target_pages` to parse specific pages, choosing a faster tier if applicable, splitting the document, or ensuring the file format is supported and not corrupted. Review LlamaParse's troubleshooting guide for specific error codes and solutions related to parsing problems.","cause":"This error from the LlamaParse service indicates a failure during document processing, which can be due to various reasons such as document complexity, large file size leading to timeouts, unsupported file formats, or internal service issues.","error":"ERROR_DURING_PROCESSING: An unknown error occurred during processing."}],"ecosystem":"pypi","meta_description":null,"install_score":75,"install_tag":"reviewed","quickstart_score":70,"quickstart_tag":"verified","pypi_latest":"0.6.94","cli_name":"","cli_version":null,"install_checks":{"last_tested":"2026-05-12","tag":"reviewed","tag_description":"minor failures on some runtimes or slightly older test data","installed_version":null,"pypi_latest":"0.6.94","is_stale":null,"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.06,"mem_mb":70.2,"disk_size":"242.1M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"90.7M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.26,"mem_mb":70.3,"disk_size":"242.3M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":21.1,"import_time_s":5.3,"mem_mb":70.2,"disk_size":"239M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":4.5,"import_time_s":null,"mem_mb":null,"disk_size":"161M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":4.8,"mem_mb":70.3,"disk_size":"239M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.82,"mem_mb":76.1,"disk_size":"268.7M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"98.9M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":8.47,"mem_mb":76.3,"disk_size":"268.9M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":19,"import_time_s":7.21,"mem_mb":76.1,"disk_size":"265M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":4,"import_time_s":null,"mem_mb":null,"disk_size":"169M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":6.73,"mem_mb":76.4,"disk_size":"265M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":6.87,"mem_mb":74.9,"disk_size":"257.7M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"89.1M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":8.24,"mem_mb":75.1,"disk_size":"257.9M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":15.9,"import_time_s":7.03,"mem_mb":74.9,"disk_size":"254M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":3.4,"import_time_s":null,"mem_mb":null,"disk_size":"159M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.76,"mem_mb":75.1,"disk_size":"254M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":6.64,"mem_mb":75.5,"disk_size":"256.8M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"85.7M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.33,"mem_mb":75.7,"disk_size":"256.9M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":17,"import_time_s":6.7,"mem_mb":75.5,"disk_size":"253M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":3.6,"import_time_s":null,"mem_mb":null,"disk_size":"158M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":7.21,"mem_mb":75.7,"disk_size":"253M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"246.5M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"89.7M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"llama-cloud-services","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"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":"llama-cloud-services","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":24.8,"import_time_s":null,"mem_mb":null,"disk_size":"247M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"llama-cloud>=1.0","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":5.4,"import_time_s":null,"mem_mb":null,"disk_size":"160M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"llama-cloud-services","exit_code":1,"wheel_type":null,"failure_reason":null,"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":"llama-cloud>=1.0","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null}]},"quickstart_checks":{"last_tested":"2026-04-24","tag":"verified","tag_description":"quickstart runs on critical runtimes, recently tested","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":1},{"runtime":"python:3.9-slim","exit_code":1}]},"_links":{"self":"https://checklist.day/api/registry/llama-cloud-services","v1":"https://checklist.day/v1/registry/llama-cloud-services","v1_install":"https://checklist.day/v1/registry/llama-cloud-services/install","v1_imports":"https://checklist.day/v1/registry/llama-cloud-services/imports","v1_compatibility":"https://checklist.day/v1/registry/llama-cloud-services/compatibility","v1_quickstart":"https://checklist.day/v1/registry/llama-cloud-services/quickstart","docs":"https://checklist.day/docs"}}