Getting Started

pip install isa-agent-sdk

uv add isa-agent-sdk

export ISA_API_KEY="your-api-key"

ISA_API_KEY=your-api-key

from isa_agent_sdk import query
 
async for msg in query("Hello, isA!"):
    print(msg.content, end="")

from isa_agent_sdk import query
 
async def main():
    async for msg in query("What is machine learning?"):
        print(msg.content, end="")
 
import asyncio
asyncio.run(main())

from isa_agent_sdk import Agent, ISAAgentOptions
 
agent = Agent(
    name="research-assistant",
    options=ISAAgentOptions(
        allowed_tools=["web_search", "calculator", "code_interpreter"],
        model="claude-sonnet-4-20250514",
        system_prompt="You are a helpful research assistant.",
    )
)
 
async def main():
    result = await agent.run("Find the latest news about AI and summarize it")
    print(result.text)
 
import asyncio
asyncio.run(main())

from isa_agent_sdk import query
 
async def main():
    async for msg in query(
        "Find the latest news about AI",
        allowed_tools=["web_search"],
    ):
        if msg.is_text:
            print(msg.content, end="")
 
import asyncio
asyncio.run(main())

from isa_agent_sdk import query
 
# First message
async for msg in query("My name is Alice", session_id="conv-001"):
    print(msg.content, end="")
 
# Later — agent remembers the session
async for msg in query("What's my name?", session_id="conv-001"):
    print(msg.content, end="")  # "Your name is Alice"