python-tempmail10

Async temporary email client for 10minemail, built on curl_cffi with browser impersonation.

Create a disposable mailbox, then poll for incoming messages — useful for automated sign-up flows, OTP retrieval, and testing email delivery.

Features

• Fully async API (asyncio).
• Browser TLS impersonation via curl_cffi (Chrome).
• Optional proxy support.
• Async context manager for automatic session cleanup.
• Typed result objects (AccountResult, EmailResult).
• HTML emails parsed to plain text out of the box.

Requirements

• Python >= 3.9
• curl_cffi
• beautifulsoup4

Installation

pip install python-tempmail10

From source:

git clone https://github.com/yourname/python-tempmail10.git
cd python-tempmail10
pip install -e .

Quick start

import asyncio

from tempmail import Tempmail10


async def main():
    async with Tempmail10() as tempmail:
        account = await tempmail.create_account()
        print(account)
        if not account.success:
            return

        print("Your address:", account.email_address)

        # Block until an email arrives (or timeout).
        result = await tempmail.wait_for_message(timeout=120)
        if result.success:
            print("From:   ", result.sender)
            print("Subject:", result.subject)
            print("Text:   ", result.text)
        else:
            print("No email:", result.message)


if __name__ == "__main__":
    asyncio.run(main())

Usage

Creating a client

from tempmail import Tempmail10

# Default
tempmail = Tempmail10()

# With a proxy
tempmail = Tempmail10(proxy="http://user:pass@host:port")

Tempmail10 is an async context manager. Prefer async with so the underlying HTTP session is always closed:

async with Tempmail10() as tempmail:
    ...

If you manage the lifecycle manually, call await tempmail.close() when done.

Creating a mailbox

account = await tempmail.create_account()
# AccountResult(success=True, message='success create tempmail',
#               email_address='abc123@somedomain.com')

Fetching the latest message

result = await tempmail.get_latest_message()
if result.success:
    print(result.subject, result.sender)
elif result.empty:
    print("Mailbox is empty (no messages yet)")
else:
    print("Error:", result.message)

Waiting for a message

wait_for_message polls until a message arrives, a fatal error occurs, or the timeout is reached. Empty mailboxes are retried; fatal errors (auth/network) return immediately.

result = await tempmail.wait_for_message(timeout=120, poll_interval=3)

API reference

Tempmail10(proxy: Optional[str] = None)

AccountResult

EmailResult

Error handling

All client methods return result objects instead of raising on network/API failures. Inspect success (and empty for EmailResult) rather than wrapping calls in try/except:

result = await tempmail.get_latest_message()
if not result.success and not result.empty:
    # Genuine error (auth, network, server): message contains details.
    print(result.message)

Disclaimer

This library interacts with a third-party service that is not affiliated with this project. Use it responsibly and in accordance with the service's terms. Intended for testing and automation, not abuse.

License

MIT