The agent framework you can read in one sitting

import asyncio
 
from agentling import Agent, OpenAIModel, tool
 
 
@tool
def get_weather(city: str) -> str:
    """Get the current weather for a city.
 
    Args:
        city: The city to look up.
    """
    return f"It is 22C and sunny in {city}."
 
 
async def main() -> None:
    agent = Agent(model=OpenAIModel("gpt-4o-mini"), tools=[get_weather])
    print(await agent.run("What's the weather in Paris?"))
 
 
asyncio.run(main())

from agentling import FinalEvent, TextDelta, ToolCallEvent
 
async for event in agent.run("Summarize this.", stream=True):
    if isinstance(event, TextDelta):
        print(event.text, end="", flush=True)
    elif isinstance(event, ToolCallEvent):
        print(f"\n[calling {event.tool_call.name}]")
    elif isinstance(event, FinalEvent):
        print(f"\nDone: {event.answer}")

agent = Agent(
    model=OpenAIModel("gpt-4o-mini"),
    tools=[read_file],
    skills=["skills/code-reviewer"],
)
 
# The model sees only the skill catalog until it
# decides to call load_skill("code-reviewer").
print(await agent.run("Review src/agentling/agent.py"))

session = agent.start()
await session.run("First question")
 
saved = session.memory.dump_json()
 
# ...later, even in another process...
restored = agent.start()
restored.memory = Memory.load_json(saved)
await restored.run("A follow-up", reset=False)