{
 "kind": "tool",
 "slug": "pydantic-graph",
 "path": "tools/pydantic-graph/",
 "name": "Pydantic Graph",
 "maker": null,
 "density": "basic",
 "crumbs": [
  [
   "Tools",
   "tools/"
  ],
  [
   "Agent, MCP and tool libraries",
   "tools/agent-libraries/"
  ]
 ],
 "lead": "Build typed graphs and state machines with Pydantic for AI workflows.",
 "chips": [
  {
   "label": "Agent, MCP and tool libraries",
   "path": "tools/agent-libraries/"
  },
  {
   "label": "PYPI"
  }
 ],
 "primary": {
  "label": "Copy install command",
  "copy": "pip install pydantic-graph"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/pydantic/pydantic-ai"
  },
  {
   "label": "Website",
   "href": "https://pydantic.dev/docs/ai/graph/graph/"
  }
 ],
 "track": "New versions, deprecation and license changes on your dashboard",
 "verdicts": [
  {
   "key": "license",
   "label": "License",
   "value": "MIT",
   "status": "yes",
   "sub": "Use it in paid apps",
   "quote": null,
   "note": "License from PyPI license expression.",
   "src": "https://github.com/pydantic/pydantic-ai"
  },
  {
   "key": "maint",
   "label": "Maintained",
   "value": "Maintained",
   "status": "yes",
   "sub": "Last change today",
   "note": "Latest GitHub release Nov 17, 2026. ",
   "src": "https://github.com/pydantic/pydantic-ai"
  },
  {
   "key": "pop",
   "label": "Used by agents' projects",
   "value": "2 projects",
   "status": "info",
   "sub": "#87 of 189 in its category",
   "note": "Dependency in 2 public GitHub projects set up for AI coding agents that we scanned (0.0%).",
   "src": null
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Install only",
   "status": "info",
   "sub": null,
   "note": "Agent skills for this library in the skills catalog; community skills are written by others, read them before you install.",
   "src": null
  }
 ],
 "vfoot": "From the package registry and GitHub, checked daily.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Pydantic Graph does",
   "parts": [
    {
     "t": "prose",
     "text": "Build typed graphs and state machines with Pydantic for AI workflows."
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Pydantic Graph popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "66",
       "of": "/ 100",
       "l": "Gid Score, #539 overall"
      },
      {
       "n": "8.8M",
       "l": "downloads a week, pypi"
      },
      {
       "n": "21.3K",
       "l": "GitHub stars"
      },
      {
       "n": "2",
       "l": "agent projects use it"
      }
     ]
    },
    {
     "t": "small",
     "text": "Gid Score measures public popularity and activity, not quality.",
     "link": "How the Gid Score is calculated",
     "path": "tools/top/"
    }
   ]
  },
  {
   "id": "usage",
   "nav": "How it is used",
   "h2": "How Pydantic Graph is used",
   "parts": [
    {
     "t": "list",
     "items": [
      "Pydantic Graph is a dependency in 2 of the 6,254 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 3,063, Ethereum and EVM 1,777, 3D and games 3,120, agent frameworks and SDKs 13,629); counting those, it appears in 74 projects, and what it is used with below comes from all of them.",
      "The most used alternative in our scan is LangGraph (78 projects).",
      "Projects that use it most often also use Pydantic (98.6%), OpenAI Python Library (95.9%), Requests (94.6%)."
     ]
    },
    {
     "t": "h3",
     "text": "Often used with"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In 98.6% of its projects",
       "v": "Pydantic",
       "path": "tools/pydantic/"
      },
      {
       "l": "In 95.9% of its projects",
       "v": "OpenAI Python Library",
       "path": "tools/openai-pypi/"
      },
      {
       "l": "In 94.6% of its projects",
       "v": "Requests",
       "path": "tools/requests-py/"
      },
      {
       "l": "In 93.2% of its projects",
       "v": "AnyIO",
       "path": "tools/anyio/"
      },
      {
       "l": "In 93.2% of its projects",
       "v": "Click",
       "path": "tools/click-py/"
      },
      {
       "l": "In 93.2% of its projects",
       "v": "packaging",
       "path": "tools/packaging/"
      }
     ]
    }
   ]
  },
  {
   "id": "more",
   "nav": null,
   "spy_as": "usage",
   "h2": "More about Pydantic Graph",
   "parts": [
    {
     "t": "more",
     "items": [
      {
       "title": "More in Agent, MCP and tool libraries",
       "path": "tools/agent-libraries/",
       "items": [
        {
         "text": "Model Context Protocol SDK (JavaScript)",
         "path": "tools/modelcontextprotocol/"
        },
        {
         "text": "Model Context Protocol SDK (Python)",
         "path": "tools/mcp/"
        },
        {
         "text": "FastMCP (Python)",
         "path": "tools/fastmcp-pypi/"
        },
        {
         "text": "LangChain",
         "path": "tools/langchain-pypi/"
        },
        {
         "text": "Agent Client Protocol SDK",
         "path": "tools/agentclientprotocol-sdk/"
        },
        {
         "text": "LangChain.js",
         "path": "tools/langchain-npm/"
        },
        {
         "text": "Mastra",
         "path": "tools/mastra/"
        },
        {
         "text": "MCP Inspector",
         "path": "tools/modelcontextprotocol-inspector/"
        }
       ]
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Pydantic Graph",
       "me": true,
       "facts": [
        "MIT",
        "Gid 66",
        "8.8M/wk"
       ]
      },
      {
       "name": "LangGraph",
       "why": "Framework for building stateful, multi-actor applications with LLMs.",
       "path": "tools/langgraph/",
       "facts": [
        "MIT",
        "Gid 80",
        "14.6M/wk"
       ]
      },
      {
       "name": "Pydantic AI",
       "why": "AI agent framework built with Pydantic for structured, typed agent development.",
       "path": "tools/pydantic-ai/",
       "facts": [
        "MIT",
        "Gid 64",
        "1.5M/wk"
       ]
      }
     ],
     "more": "Compare Pydantic Graph with another tool",
     "more_path": "tools/compare/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "install",
     "intro": "Install it.",
     "code": "pip install pydantic-graph"
    },
    {
     "t": "gap",
     "text": "No step-by-step start for Pydantic Graph yet: we have not written its hand-checked card."
    }
   ]
  }
 ],
 "glance": [
  [
   "Package",
   "pypi pydantic-graph"
  ],
  [
   "Category",
   "Agent, MCP and tool libraries"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "Gid Score",
   "66.3"
  ],
  [
   "Rank in category",
   "#87 of 189"
  ],
  [
   "GitHub",
   "pydantic/pydantic-ai"
  ],
  [
   "Last change",
   "Nov 17, 2026"
  ]
 ],
 "good": [],
 "checked_line": "From the package registry, GitHub and our scan of public agent projects; numbers update daily.",
 "logo": "https://agentgid.com/media/avatars/pydantic.png"
}