Skip to content

ImportError: Circular import in types module when accessing conversational_ai.agents (v2.18.0) #650

@aliyanishfaq

Description

@aliyanishfaq

Steps to Reproduce

  1. Install elevenlabs version 2.18.0
  2. Write a simple script to fetch an agent:
from elevenlabs import ElevenLabs
from dotenv import load_dotenv

load_dotenv()

class InboundAgent:
    def __init__(self, agent_id: str):
        elevenlabs_client = ElevenLabs(base_url="https://api.elevenlabs.io")
        self.agent = elevenlabs_client.conversational_ai.agents.get(agent_id=agent_id)

if __name__ == "__main__":
    phone_agent = InboundAgent(agent_id="agent_xxx")
    print(phone_agent.agent)
  1. Run the script

Expected Behavior

The agent should be retrieved successfully without import errors.

Actual Behavior

A circular import error is raised immediately when accessing the conversational_ai.agents property.

ImportError: cannot import name 'AstAndOperatorNodeInputChildrenItem' from partially initialized module 'elevenlabs.types.ast_and_operator_node_input_children_item' (most likely due to a circular import) (/Users/user/Documents/GitHub/my-repo/venv/lib/python3.10/site-packages/elevenlabs/types/ast_and_operator_node_input_children_item.py)

Environment

  • elevenlabs version: 2.18.0
  • Python version: 3.10.x
  • Operating System: macOS 25.0.0 (Darwin)

Code example

from elevenlabs import ElevenLabs
from dotenv import load_dotenv

load_dotenv()

class InboundAgent:
    def __init__(self, agent_id: str):
        elevenlabs_client = ElevenLabs(base_url="https://api.elevenlabs.io")
        self.agent = elevenlabs_client.conversational_ai.agents.get(agent_id=agent_id)

if __name__ == "__main__":
    phone_agent = InboundAgent(agent_id="agent_xxx")
    print(phone_agent.agent)

Additional context

ImportError: cannot import name 'AstAndOperatorNodeInputChildrenItem' from partially initialized module 'elevenlabs.types.ast_and_operator_node_input_children_item' (most likely due to a circular import) (/Users/user/Documents/GitHub/my-repo/venv/lib/python3.10/site-packages/elevenlabs/types/ast_and_operator_node_input_children_item.py)

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions