LangGraph vs OpenAI Agents SDK: Which Agent Framework to Use?

LangGraph and OpenAI Agents SDK both let you build an agent, but they sit in different parts of the stack and they assume different things about who's writing the code.

LangGraph is LangChain's stateful workflow framework — a graph of nodes (functions) connected by edges with shared state.

OpenAI's Agents SDK (evolved from Swarm) provides Agent, Runner, handoffs, and guardrails.

Underneath, both wrap the same thing: a model call, a tool dispatch, a loop. The decision is about which abstraction your team wants to think in day to day, and which ecosystem you're willing to inherit along with it. There's an honest, framework-free version of the same pattern in about 60 lines of Python in the lesson at the bottom of this page — useful as a baseline regardless of which framework wins.

Pick LangGraph if langGraph earns its weight when your agent is a workflow — explicit branches, checkpoints, parallel branches, or a human approval gate. For a single-agent loop, the graph machinery is overkill and a plain while loop is faster to write, debug, and ship. The tradeoffs in its intro should match how your team already thinks about agents; OpenAI Agents SDK will feel like translation if they don't.

Pick OpenAI Agents SDK if the Agents SDK is the thinnest framework on this list — it barely abstracts beyond what you'd write yourself. Use it when you want OpenAI's conventions and auto-schema generation. Skip it when you want full control or use non-OpenAI models. The tradeoffs in its intro should match how your team already thinks about agents; LangGraph will feel like translation if they don't.

Whichever you pick, you're inheriting a dependency tree and a vocabulary your team has to learn before they ship anything. LangGraph has its own class hierarchy and tool registration conventions; OpenAI Agents SDK has its. Either way, when something misbehaves you'll be reading framework source before you reach the actual HTTP call.

If the real workload is one model and a handful of tools, both can feel like a workbench for driving a nail. The lesson below builds the same pattern in plain Python — useful as a comparison point even if you ultimately keep the framework.