{"library":"retell-sdk","title":"Retell AI Python SDK","description":"The official Python library for the Retell API, designed to simplify building AI voice agents. It enables real-time, bidirectional voice conversations with LLMs. The library is actively maintained with frequent updates, often reflecting changes and new features in the core Retell API.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install retell-sdk"],"cli":null},"imports":["from retell_sdk import RetellClient","from retell_sdk.models import AgentResponse"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom retell_sdk import RetellClient\nfrom retell_sdk.models import AgentResponse\n\n# Ensure your Retell API key is set as an environment variable or passed directly.\n# It's recommended to set RETELL_API_KEY in your environment.\napi_key = os.environ.get(\"RETELL_API_KEY\", \"YOUR_RETELL_API_KEY\")\n\nif api_key == \"YOUR_RETELL_API_KEY\":\n    print(\"WARNING: Please set the RETELL_API_KEY environment variable or replace 'YOUR_RETELL_API_KEY' with your actual key.\")\n\ntry:\n    client = RetellClient(api_key=api_key)\n\n    # Example: List all agents\n    print(\"\\nListing agents...\")\n    agents_list_response = client.agent.list_all(limit=5)\n    \n    if agents_list_response and agents_list_response.data:\n        for agent in agents_list_response.data:\n            print(f\"  - Agent ID: {agent.agent_id}, LLM URL: {agent.llm_websocket_url}\")\n    else:\n        print(\"No agents found or an error occurred.\")\n\n    # Example: Retrieve a specific agent (replace with an actual agent_id if available)\n    # agent_id_to_retrieve = \"your_agent_id_here\"\n    # try:\n    #     agent: AgentResponse = client.agent.get(agent_id=agent_id_to_retrieve)\n    #     print(f\"\\nRetrieved Agent ID: {agent.agent_id}, Voice: {agent.voice_id}\")\n    # except Exception as e:\n    #     print(f\"Error retrieving agent {agent_id_to_retrieve}: {e}\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")","lang":"python","description":"Initializes the RetellClient using an API key from an environment variable and demonstrates listing existing agents. Remember to replace 'YOUR_RETELL_API_KEY' or set the `RETELL_API_KEY` environment variable.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"5.39.1","pypi_latest":"5.39.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":5.1,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"retell-sdk","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":"54.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"retell-sdk","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":5.9,"import_time_s":null,"mem_mb":null,"disk_size":"54M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"retell-sdk","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":"59.2M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"retell-sdk","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":4.7,"import_time_s":null,"mem_mb":null,"disk_size":"59M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"retell-sdk","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":"50.3M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"retell-sdk","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":4.1,"import_time_s":null,"mem_mb":null,"disk_size":"50M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"retell-sdk","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":"50.2M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"retell-sdk","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":4.2,"import_time_s":null,"mem_mb":null,"disk_size":"50M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"retell-sdk","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":"55.0M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"retell-sdk","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":6.8,"import_time_s":null,"mem_mb":null,"disk_size":"55M"}]}}