straleio 0.1.3

Python SDK for the Strale API — let AI agents buy capabilities at runtime

straleio

Python SDK for the Strale API — let AI agents buy and execute capabilities at runtime.

Install

pip install straleio

Quick start

from straleio import Strale

strale = Strale(api_key="sk_live_...")

result = strale.do(task="validate VAT number SE556703748501")

print(result.output)
# {"valid": True, "country_code": "SE", "company_name": "Spotify AB"}

Execute by slug

result = strale.do(
    capability_slug="vat-validate",
    inputs={"vat_number": "SE556703748501"},
    max_price_cents=10,
)

Dry run (preview cost without executing)

preview = strale.dry_run(task="look up Swedish company Klarna")

print(preview.matched_capability)  # "swedish-company-data"
print(preview.price_cents)         # 80

Async support

import asyncio
from straleio import Strale

async def main():
    strale = Strale(api_key="sk_live_...")
    result = await strale.do_async(task="validate VAT number SE556703748501")
    print(result.output)

asyncio.run(main())

Check balance

balance = strale.get_balance()
print(balance.balance_eur)  # "1.84"

List capabilities

capabilities = strale.list_capabilities()
# 250+ capabilities with slug, name, price, category

Free-tier (no API key)

5 capabilities work without authentication:

strale = Strale(api_key="")

result = strale.do(
    capability_slug="email-validate",
    inputs={"email": "[e-mail]"},
)

Options

strale = Strale(
    api_key="sk_live_...",
    base_url="https://api.strale.io",  # default
    timeout=60.0,                       # seconds, default 60
    default_max_price_cents=200,        # cap per call, default €2.00
)

Error handling

from straleio import Strale, StraleError

try:
    result = strale.do(task="...")
except StraleError as e:
    print(e.code)     # "insufficient_balance" | "no_matching_capability" | ...
    print(e.message)

---

Try for Free

5 capabilities work without an API key or signup:

• email-validate — verify email deliverability
• dns-lookup — DNS record lookup
• json-repair — fix malformed JSON
• url-to-markdown — convert any URL to markdown
• iban-validate — validate international bank account numbers

For all 250+ capabilities, sign up for €2 in free trial credits.

Resources

• 📖 Documentation
• 💡 Examples — copy-paste examples for every integration
• 💰 Pricing
• 🔍 Quality methodology
• 🔒 Security

License

MIT — see LICENSE