Python quickstart

pip install vendo-sdk
# Optional: requests-based session helper
pip install "vendo-sdk[http]"
# Optional: async (aiohttp) support
pip install "vendo-sdk[async]"

# .env — no VENDO_API_KEY needed
OPENAI_API_KEY=sk-...
TELEGRAM_BOT_TOKEN=12345:abcde

import vendo

openai_key = vendo.token("openai")   # returns OPENAI_API_KEY
bot_token = vendo.token("telegram")  # returns TELEGRAM_BOT_TOKEN

VENDO_API_KEY=vendo_sk_...

import vendo

# Same call — SDK detects mode automatically
openai_key = vendo.token("openai")

# List all connected integrations for this deployment
connections = vendo.connections.list()

# Check wallet balance
balance = vendo.billing.balance()
print(f"{balance.credits_remaining_micros / 1_000_000:.4f} USD remaining")

tokens = vendo.tokens(["openai", "slack", "telegram"])
# returns {"openai": "sk-...", "slack": "xoxb-...", "telegram": None}

sess = vendo.session("google")
resp = sess.get("https://www.googleapis.com/calendar/v3/calendars/primary")

import asyncio
from vendo import AsyncVendo

async def main():
    async with AsyncVendo() as client:
        token = await client.token("openai")
        connections = await client.connections.list()

asyncio.run(main())

vendo.is_vendo_mode()  # True if VENDO_API_KEY is set