Quickstart

pip install "gwenflow[readers]"     # PDF, Word, PowerPoint, Excel readers
pip install "gwenflow[telemetry]"   # OpenTelemetry tracing
pip install "gwenflow[temporal]"    # durable execution with Temporal

export OPENAI_API_KEY='sk-...'

from gwenflow import ChatOpenAI

llm = ChatOpenAI(model="gpt-5-mini")
response = llm.invoke("Describe Argentina in one sentence.")
print(response.text)

import httpx
from gwenflow import Agent, ChatOpenAI

agent = Agent(
    name="Finance Agent",
    instructions=[
        "Help users with exchange rates.",
        "Answer in one sentence and mention the date if available.",
    ],
    llm=ChatOpenAI(model="gpt-5-mini"),
)

@agent.tool
def get_exchange_rate(currency_iso: str) -> str:
    """Get the current USD exchange rate for a currency, given its ISO code."""
    rates = httpx.get("https://www.floatrates.com/daily/usd.json").json()
    return str(rates.get(currency_iso.lower(), "Currency not found"))

response = agent.run("What's the exchange rate of the Euro?")
print(response.content)

print(agent.run("And the Japanese yen?").content)
print(agent.total_usage)   # tokens, requests and tool calls across both runs