Python SDK Quickstart
Prerequisites
- Python 3.10+
- A FAOS API key (get one here)
Install
pip install faos
Initialize
import os
from faos import FaosClient
client = FaosClient(
api_key=os.environ.get("FAOS_API_KEY", "faos_sk_your_key_here"),
)
Invoke an Agent
from faos.exceptions import FaosAPIError
try:
response = client.agents.invoke(
"credit-risk-analyst",
{"query": "Analyze Q1 2024 financial statements"}
)
print(response.result)
# {"insights": ["Revenue growing 15% YoY", ...], "risk_score": 0.23}
except FaosAPIError as e:
print(f"API error {e.status_code}: {e.message}")
Async Usage
import asyncio
from faos import FaosClient
async def main():
client = FaosClient(api_key="faos_sk_your_key_here")
response = await client.agents.ainvoke(
"credit-risk-analyst",
{"query": "Analyze Q1 2024"}
)
print(response.result)
asyncio.run(main())
Streaming
import asyncio
from faos import FaosClient
async def stream():
client = FaosClient(api_key="faos_sk_your_key_here")
async for chunk in client.agents.stream(
"credit-risk-analyst",
{"query": "Analyze Q1 2024"}
):
if chunk.type == "text":
print(chunk.data, end="", flush=True)
asyncio.run(stream())