tells-api 0.1.0

Browser sessions for AI agents. Connect Playwright/Puppeteer to stealth Chrome in one line.

Tells Python SDK

Browser sessions for AI agents. Connect Playwright to managed Chrome with unique fingerprints, behavioral modeling, and CDP access.

Install

pip install tells playwright
playwright install chromium

Quick Start

import tells

session = tells.session()
browser, ctx, page = session.connect_playwright()

page.goto("https://example.com")
print(page.title())

session.close()

That's it. The session has a unique fingerprint, behavioral engine, and ad blocking — all automatic.

With Context Manager

import tells

with tells.session() as session:
    browser, ctx, page = session.connect_playwright()
    page.goto("https://news.ycombinator.com")
    titles = page.eval_on_selector_all(".titleline a", "els => els.map(e => e.textContent)")
    print(titles[:5])

Behavioral Engine

session = tells.session()

# Human-like interactions
session.click(500, 300)
session.scroll(400)
session.type("search query", context="search")

Session Profiles

# First session — log in
s1 = tells.session(profile_name="my-account")
browser, ctx, page = s1.connect_playwright()
page.goto("https://example.com/login")
# ... log in ...
s1.close()

# Second session — cookies persist
s2 = tells.session(profile_name="my-account")
browser, ctx, page = s2.connect_playwright()
page.goto("https://example.com/dashboard")  # already logged in

Client Instance

from tells import Tells

client = Tells(api_key="sk_...")
session = client.session()
print(client.usage())

Environment Variable

export TELLS_API_KEY=sk_your_key_here

Links

• Documentation
• Dashboard
• Website