Introduction

pip install infy                 # core + Rust extension (pure-Python fallback if unavailable)
pip install "infy[openai]"       # OpenAI provider
pip install "infy[anthropic]"    # Anthropic provider
pip install "infy[gemini]"       # Google Gemini / Vertex provider
pip install "infy[ollama]"       # Ollama provider
pip install "infy[pydantic]"     # validated structured output
pip install "infy[all]"          # all providers

from infy import create_agent, tool
from infy.providers.openai import OpenAIChat

model = OpenAIChat("gpt-4o")

@tool
def get_weather(city: str) -> str:
    """Return the current weather for a city."""
    return f"{city}: 17C, clear"

agent = create_agent(model, tools=[get_weather])     # create_async_agent for async
result = agent("What's the weather in Boston?")

print(result.response.text)
print(result.iterations, result.tool_calls_made)

from pydantic import BaseModel

class Person(BaseModel):
    name: str
    age: int

# with_structured_output returns a runnable, so call it with .invoke like any chain
model.with_structured_output(Person).invoke("Maria Chen is 42.")
# Person(name='Maria Chen', age=42)

from infy import create_agent
from infy.governance import Governance, Policy, CallbackApprover

gov = Governance(
    policy=Policy(
        deny=["delete_database"],        # never, regardless of approval
        require_approval=["deploy"],     # allowed only with a human yes
    ),
    approver=CallbackApprover(prompt_via_slack),   # your callback: (request) -> bool
    principal="agent://acme/assistant",
)

# search, deploy, and delete_database are your own @tool functions
agent = create_agent(model, tools=[search, deploy, delete_database], governance=gov)
agent("ship the release")

assert gov.audit.verify()      # tamper-evident receipt of everything that happened