Python SDK

uv add agentsim-sdk
# or: pip install agentsim-sdk

export AGENTSIM_API_KEY="asm_live_..."

import agentsim
agentsim.configure(api_key="asm_live_...")

import asyncio
import agentsim
import os

agentsim.configure(api_key=os.environ["AGENTSIM_API_KEY"])

async def main():
    try:
        async with agentsim.provision(
            agent_id="stripe-onboarding",
            country="US",
            ttl_seconds=300,
        ) as num:
            print(f"Provisioned: {num.number}")
            # Enter num.number into the service that will send the OTP...

            otp = await num.wait_for_otp(timeout=60)
            print(f"OTP: {otp.otp_code}")

    except agentsim.OtpTimeoutError:
        print("No OTP arrived within 60 seconds. Inspect raw messages and support matrix before retrying.")
    except agentsim.PoolExhaustedError:
        print("No numbers available in US right now. Try again shortly.")
    except agentsim.ApiError as e:
        if e.status_code == 402:
            print("Hobby plan 10-session limit reached. Upgrade to Builder.")

asyncio.run(main())

import agentsim, os

agentsim.configure(api_key=os.environ["AGENTSIM_API_KEY"])

with agentsim.provision_sync(agent_id="checkout-bot") as num:
    print(f"Number: {num.number}")
    otp = num.wait_for_otp_sync(timeout=60)
    print(f"OTP: {otp.otp_code}")