[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ag-ui-protocol--ag-ui":3,"tool-ag-ui-protocol--ag-ui":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",141543,2,"2026-04-06T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":74,"owner_location":74,"owner_email":74,"owner_twitter":74,"owner_website":74,"owner_url":75,"languages":76,"stars":117,"forks":118,"last_commit_at":119,"license":120,"difficulty_score":32,"env_os":121,"env_gpu":122,"env_ram":122,"env_deps":123,"category_tags":127,"github_topics":128,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":133,"updated_at":134,"faqs":135,"releases":161},4661,"ag-ui-protocol\u002Fag-ui","ag-ui","AG-UI: the Agent-User Interaction Protocol. Bring Agents into Frontend Applications.","ag-ui 是一个开放、轻量且基于事件的协议，旨在标准化 AI 智能体（Agent）与前端用户界面之间的交互方式。它解决了当前 AI 应用中智能体后端与前端展示层连接复杂、缺乏统一标准的痛点，让开发者能够轻松将智能体能力无缝集成到各类用户-facing 的应用程序中。\n\n这款工具特别适合前端工程师、全栈开发者以及希望构建实时交互式 AI 应用的技术团队使用。通过 ag-ui，智能体在执行过程中可以发出兼容标准的事件流，前端则能实时接收并渲染这些状态，从而实现流畅的对话体验。\n\n其核心技术亮点在于灵活的中间件层设计，支持 SSE、WebSocket 等多种传输协议，并允许宽松的事件格式匹配，确保了不同框架间的高度互操作性。此外，ag-ui 不仅支持实时流式聊天和双向状态同步，还具备生成式 UI、结构化消息处理以及“人在回路”的协作功能。在智能体协议生态中，它与提供工具能力的 MCP 和负责智能体间通信的 A2A 互补，专注于打通智能体通向最终用户的“最后一公里”，帮助团队快速构建现代化的智能交互应用。","\n# \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_a5a67c25d89a.png\" alt=\"ag-ui Logo\" width=\"22\"\u002F> AG-UI: The Agent-User Interaction Protocol\n\n\nAG-UI is an open, lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications.\nBuilt for simplicity and flexibility, it enables seamless integration between AI agents, real time user context, and user interfaces.\n\n---\n\n\n\u003Cbr>\n\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@ag-ui\u002Fcore?label=Version&color=6963ff&logo=npm&logoColor=white)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@ag-ui\u002Fcore)\n![MIT](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fcopilotkit\u002Fcopilotkit?color=%236963ff&label=License)\n![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1379082175625953370?logo=discord&logoColor=%23FFFFFF&label=Discord&color=%236963ff)\n\n\u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FJd3FzfdJa8\" target=\"_blank\"> Join our Discord → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fag-ui.com\u002F\" target=\"_blank\"> Read the Docs → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fdojo.ag-ui.com\u002F\" target=\"_blank\"> Go to the AG-UI Dojo → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fx.com\u002FCopilotKit\" target=\"_blank\"> Follow us → \u003C\u002Fa>\n\n\u003Cimg width=\"1600\" height=\"680\" alt=\"1600x680\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_7d06a0545715.png\" \u002F>\n\n\n\n## 🚀 Getting Started\nCreate a new AG-UI application in seconds:\n```bash\nnpx create-ag-ui-app my-agent-app\n```\n\n\u003Ch3> Useful Links:\u003C\u002Fh3>\n\n- [The AG-UI Dojo](https:\u002F\u002Fdojo.ag-ui.com\u002F)\n- [Build AG-UI-powered applications(Quickstart)](https:\u002F\u002Fdocs.ag-ui.com\u002Fquickstart\u002Fapplications)\n- [Build new AG-UI framework integrations (Quickstart)](https:\u002F\u002Fgo.copilotkit.ai\u002Fagui-contribute)\n- [Book a call to discuss an AG-UI integration with a new framework](https:\u002F\u002Fcalendly.com\u002Fmarkus-copilotkit\u002Fag-ui)\n- [Join the Discord Community](https:\u002F\u002Fdiscord.gg\u002FJd3FzfdJa8)\n\n## What is AG-UI?\n\nAG-UI is an open, lightweight, event-based protocol for agent-human interaction, designed for simplicity & flexibility:\n\n- During agent executions, agent backends **emit events _compatible_ with one of AG-UI's ~16 standard event types**\n- Agent backends can **accept one of a few simple AG-UI compatible inputs** as arguments\n\n**AG-UI includes a flexible middleware layer** that ensures compatibility across diverse environments:\n\n- Works with **any event transport** (SSE, WebSockets, webhooks, etc.)\n- Allows for **loose event format matching**, enabling broad agent and app interoperability\n\nIt also ships with a **reference HTTP implementation** and **default connector** to help teams get started fast.\n\n\n[Learn more about the specs →](https:\u002F\u002Fgo.copilotkit.ai\u002Fag-ui-introduction)\n\n\n## Why AG-UI?\n\nAG-UI was developed based on real-world requirements and practical experience building in-app agent interactions.\n\n\n## Where does AGUI fit in the agentic protocol stack?\nAG-UI is complementary to the other 2 top agentic protocols\n- MCP gives agents tools\n- A2A allows agents to communicate with other agents\n- AG-UI brings agents into user-facing applications\n\n\u003Cdiv align=\"center\">\n  \u003Cimg width=\"2048\" height=\"1182\" alt=\"The Agent Protocol Stack\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_49c997f1ddb2.png\" \u002F>\n\u003C\u002Fdiv>\n\n## 🚀 Features\n\n- 💬 Real-time agentic chat with streaming\n- 🔄 Bi-directional state synchronization\n- 🧩 Generative UI and structured messages\n- 🧠 Real-time context enrichment\n- 🛠️ Frontend tool integration\n- 🧑‍💻 Human-in-the-loop collaboration\n\n\n## 🛠 Supported Integrations\n\nAG-UI was born from CopilotKit's initial **partnership** with LangGraph and CrewAI - and brings the incredibly popular agent-user-interactivity infrastructure to the wider agentic ecosystem.\n\n**1st party** = the platforms that have AG‑UI built in and provide documentation for guidance.\n\n## Frameworks\n\n| Framework                                                          | Status                   | AG-UI Resources                                                                 |\n| ------------------------------------------------------------------ | ------------------------ | -------------------------------------------------------------------------------- |\n| Built-in Agent                                                | ✅ Supported             | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fdirect-to-llm)  |\n\n### 🤝 Partnerships\n| Framework | Status | AG-UI Resources |\n| ---------- | ------- | ---------------- |\n| [LangGraph](https:\u002F\u002Fwww.langchain.com\u002Flanggraph) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Flanggraph\u002F) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Flanggraph-fastapi\u002Ffeature\u002Fshared_state) |\n| [CrewAI](https:\u002F\u002Fcrewai.com\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fcrewai-flows) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fcrewai\u002Ffeature\u002Fshared_state) |\n\n### 🧩 1st Party\n| Framework | Status | AG-UI Resources |\n| ---------- | ------- | ---------------- |\n| [Microsoft Agent Framework](https:\u002F\u002Fazure.microsoft.com\u002Fen-us\u002Fblog\u002Fintroducing-microsoft-agent-framework\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fmicrosoft-agent-framework) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fmicrosoft-agent-framework-dotnet\u002Ffeature\u002Fshared_state) |\n| [Google ADK](https:\u002F\u002Fgoogle.github.io\u002Fadk-docs\u002Fget-started\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fadk) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fadk-middleware\u002Ffeature\u002Fshared_state?openCopilot=true) |\n| [AWS Strands Agents](https:\u002F\u002Fgithub.com\u002Fstrands-agents\u002Fsdk-python) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Faws-strands) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Faws-strands\u002Ffeature\u002Fshared_state) |\n| [AWS Bedrock AgentCore](https:\u002F\u002Fdocs.aws.amazon.com\u002Fbedrock-agentcore\u002Flatest\u002Fdevguide\u002Fruntime-agui-protocol-contract.html) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fgithub.com\u002Fawslabs\u002Ffullstack-solution-template-for-agentcore) |\n| [Mastra](https:\u002F\u002Fmastra.ai\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fmastra\u002F) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fmastra\u002Ffeature\u002Ftool_based_generative_ui) |\n| [Pydantic AI](https:\u002F\u002Fgithub.com\u002Fpydantic\u002Fpydantic-ai) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fpydantic-ai\u002F) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fpydantic-ai\u002Ffeature\u002Fshared_state) |\n| [Agno](https:\u002F\u002Fgithub.com\u002Fagno-agi\u002Fagno) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fagno\u002F) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fagno\u002Ffeature\u002Ftool_based_generative_ui) |\n| [LlamaIndex](https:\u002F\u002Fgithub.com\u002Frun-llama\u002Fllama_index) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fllamaindex\u002F) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fllamaindex\u002Ffeature\u002Fshared_state) |\n| [AG2](https:\u002F\u002Fag2.ai\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fag2\u002F)  🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fag2\u002Ffeature\u002Fshared_state) |\n| [AWS Bedrock Agents](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002Fagents\u002F) | 🛠️ In Progress | – |\n\n\n\n### 🌐 Community\n| Framework | Status | AG-UI Resources |\n| ---------- | ------- | ---------------- |\n| [Langroid](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fintegrations\u002Flangroid) | ✅ Supported | 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Flangroid\u002Ffeature\u002Fshared_state) |\n| [OpenAI Agent SDK](https:\u002F\u002Fopenai.github.io\u002Fopenai-agents-python\u002F) | 🛠️ In Progress | – |\n| [Cloudflare Agents](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F) | 🛠️ In Progress | – |\n\n\n## Agent Interaction Protocols\n\n| Protocols | Status | AG-UI Resources | Integrations |\n| ---------- | ------- | ---------------- | ------------- |\n| [A2A]() | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fa2a-protocol) | Partnership |\n\n\n## Infrastructure \u002F Deployment\n| Platform | Status | AG-UI Resources | Integrations |\n| ---------- | ------- | ---------------- | ------------- |\n| [Amazon Bedrock AgentCore](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002Fagentcore\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.aws.amazon.com\u002Fbedrock-agentcore\u002Flatest\u002Fdevguide\u002Fruntime-agui.html) | 1st Party |\n\n\n## Specification (standard)\n| Framework | Status | AG-UI Resources |\n| ---------- | ------- | ---------------- |\n| [Oracle Agent Spec](http:\u002F\u002Foracle.github.io\u002Fagent-spec\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fgo.copilotkit.ai\u002Fcopilotkit-oracle-docs) 🎮 [Demos](https:\u002F\u002Fdojo.ag-ui.com\u002Fagent-spec-langgraph\u002Ffeature\u002Ftool_based_generative_ui) |\n\n## Generative UI\n| Framework | Status | AG-UI Resources |\n| ---------- | ------- | ---------------- |\n| [MCP Apps](https:\u002F\u002Fblog.modelcontextprotocol.io\u002Fposts\u002F2025-11-21-mcp-apps\u002F) | ✅ Supported | ➡️ [Docs](https:\u002F\u002Fdocs.copilotkit.ai\u002Fgenerative-ui-specs\u002Fmcp-apps) 🎮 [Demos]() |\n\n\n## SDKs\n\n| SDK | Status | AG-UI Resources | Integrations |\n| --- | ------- | ---------------- | ------------- |\n| [Kotlin]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fkotlin\u002Foverview.mdx) | Community |\n| [Golang]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fgo\u002Foverview.mdx) | Community |\n| [Dart]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Fdart) | Community |\n| [Java]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fjava\u002Foverview.mdx) | Community |\n| [Rust]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Frust\u002Fcrates\u002Fag-ui-client) | Community |\n| [Ruby]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Fruby) | Community |\n| [.NET]() | 🛠️ In Progress | ➡️ [PR](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fpull\u002F38) | Community |\n| [Nim]() | 🛠️ In Progress | ➡️ [PR](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fpull\u002F29) | Community |\n| [Flowise]() | 🛠️ In Progress | ➡️ [GitHub Source](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F367) | Community |\n| [Langflow]() | 🛠️ In Progress | ➡️ [GitHub Source](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F366) | Community |\n| [C++]() | 🛠️ In Progress | ➡️ [GitHub Source](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F1108) | Community |\n\n## Clients\n\n| Client | Status | AG-UI Resources | Integrations |\n| --- | ------- | ---------------- | ------------- |\n| [CopilotKit](https:\u002F\u002Fgithub.com\u002FCopilotKit\u002FCopilotKit) | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fdocs.copilotkit.ai\u002Fdirect-to-llm\u002Fguides\u002Fquickstart) | 1st Party |\n| [Terminal + Agent]() | ✅ Supported | ➡️ [Getting Started](https:\u002F\u002Fdocs.ag-ui.com\u002Fquickstart\u002Fclients) | Community |\n| [React Native]() | 🛠️ Help Wanted | ➡️ [GitHub Source](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F510) | Community |\n\n[View all supported integrations →](https:\u002F\u002Fdocs.ag-ui.com\u002Fintroduction#supported-integrations)\n\n## Examples\n### Hello World App\n\nVideo:\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F18c03330-1ebc-4863-b2b8-cc6c3a4c7bae\n\nhttps:\u002F\u002Fagui-demo.vercel.app\u002F\n\n\n\n## The AG-UI Dojo (Building-Blocks Viewer)\nThe AG-UI Dojo demonstrates AG-UI's core building blocks through simple, focused examples—each just 50-200 lines of code.\n\nView the source code for the Dojo and all framework integrations [here](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fapps\u002Fdojo).\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fc298eea8-3f39-4a94-b968-7712429b0c49\n\n\n\n## 🙋🏽‍♂️ Contributing to AG-UI\n\nCheck out the [Contributing guide](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002FCONTRIBUTING.md)\n\n- **[Bi-Weekely AG-UI Working Group](https:\u002F\u002Flu.ma\u002FCopilotKit?k=c)**\n  📅 Follow the CopilotKit Luma Events Calendar\n\n## Roadmap\n\nCheck out the [AG-UI Roadmap](https:\u002F\u002Fgithub.com\u002Forgs\u002Fag-ui-protocol\u002Fprojects\u002F1) to see what's being built and where you can jump in.\n\n\n## 📄 License\n\nAG-UI is open source software [licensed as MIT](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT).\n","# \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_a5a67c25d89a.png\" alt=\"ag-ui Logo\" width=\"22\"\u002F> AG-UI：智能体与用户交互协议\n\n\nAG-UI 是一种开放、轻量级、基于事件的协议，用于标准化 AI 智能体如何连接到面向用户的应用程序。它以简单性和灵活性为核心设计，能够实现 AI 智能体、实时用户上下文和用户界面之间的无缝集成。\n\n---\n\n\n\u003Cbr>\n\n\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@ag-ui\u002Fcore?label=Version&color=6963ff&logo=npm&logoColor=white)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@ag-ui\u002Fcore)\n![MIT](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fcopilotkit\u002Fcopilotkit?color=%236963ff&label=License)\n![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1379082175625953370?logo=discord&logoColor=%23FFFFFF&label=Discord&color=%236963ff)\n\n\u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FJd3FzfdJa8\" target=\"_blank\"> 加入我们的 Discord → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fag-ui.com\u002F\" target=\"_blank\"> 阅读文档 → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fdojo.ag-ui.com\u002F\" target=\"_blank\"> 前往 AG-UI 练习场 → \u003C\u002Fa>     \u003Ca href=\"https:\u002F\u002Fx.com\u002FCopilotKit\" target=\"_blank\"> 关注我们 → \u003C\u002Fa>\n\n\u003Cimg width=\"1600\" height=\"680\" alt=\"1600x680\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_7d06a0545715.png\" \u002F>\n\n\n\n## 🚀 快速入门\n几秒钟即可创建一个新的 AG-UI 应用程序：\n```bash\nnpx create-ag-ui-app my-agent-app\n```\n\n\u003Ch3> 有用链接：\u003C\u002Fh3>\n\n- [AG-UI 练习场](https:\u002F\u002Fdojo.ag-ui.com\u002F)\n- [构建 AG-UI 驱动的应用程序（快速入门）](https:\u002F\u002Fdocs.ag-ui.com\u002Fquickstart\u002Fapplications)\n- [构建新的 AG-UI 框架集成（快速入门）](https:\u002F\u002Fgo.copilotkit.ai\u002Fagui-contribute)\n- [预约通话，讨论与新框架的 AG-UI 集成](https:\u002F\u002Fcalendly.com\u002Fmarkus-copilotkit\u002Fag-ui)\n- [加入 Discord 社区](https:\u002F\u002Fdiscord.gg\u002FJd3FzfdJa8)\n\n## 什么是 AG-UI？\n\nAG-UI 是一种开放、轻量级、基于事件的智能体与人类交互协议，旨在提供简单性和灵活性：\n\n- 在智能体执行过程中，智能体后端会**发出与 AG-UI 的约 16 种标准事件类型之一兼容的事件**。\n- 智能体后端可以**接受少数几种简单的 AG-UI 兼容输入**作为参数。\n\n**AG-UI 包含一个灵活的中间件层**，可确保在不同环境中保持兼容性：\n\n- 适用于**任何事件传输方式**（SSE、WebSockets、Webhook 等）。\n- 允许进行**宽松的事件格式匹配**，从而实现广泛的智能体和应用互操作性。\n\n此外，它还附带一个**参考 HTTP 实现**和**默认连接器**，帮助团队快速上手。\n\n\n[了解更多规范 →](https:\u002F\u002Fgo.copilotkit.ai\u002Fag-ui-introduction)\n\n\n## 为什么选择 AG-UI？\n\nAG-UI 是根据实际需求以及在构建应用内智能体交互方面的实践经验开发的。\n\n\n## AG-UI 在智能体协议栈中处于什么位置？\nAG-UI 与其他两项顶级智能体协议相辅相成：\n- MCP 为智能体提供工具；\n- A2A 允许智能体之间相互通信；\n- AG-UI 则将智能体引入面向用户的应用程序中。\n\n\u003Cdiv align=\"center\">\n  \u003Cimg width=\"2048\" height=\"1182\" alt=\"智能体协议栈\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_readme_49c997f1ddb2.png\" \u002F>\n\u003C\u002Fdiv>\n\n## 🚀 核心功能\n\n- 💬 实时智能体聊天，支持流式传输\n- 🔄 双向状态同步\n- 🧩 生成式 UI 和结构化消息\n- 🧠 实时上下文增强\n- 🛠️ 前端工具集成\n- 🧑‍💻 人机协作\n\n\n## 🛠 支持的集成\n\nAG-UI 源自 CopilotKit 与 LangGraph 和 CrewAI 的首次**合作**，并将这一广受欢迎的智能体与用户交互基础设施带入更广泛的智能体生态系统。\n\n**第一方**是指已内置 AG‑UI 并提供相关文档指导的平台。\n\n## 框架\n\n| 框架                                                          | 状态                   | AG-UI 资源                                                                 |\n| ------------------------------------------------------------------ | ------------------------ | -------------------------------------------------------------------------------- |\n| 内置智能体                                                | ✅ 支持             | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fdirect-to-llm)  |\n\n### 🤝 合作伙伴\n| 框架 | 状态 | AG-UI 资源 |\n| ---------- | ------- | ---------------- |\n| [LangGraph](https:\u002F\u002Fwww.langchain.com\u002Flanggraph) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Flanggraph\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Flanggraph-fastapi\u002Ffeature\u002Fshared_state) |\n| [CrewAI](https:\u002F\u002Fcrewai.com\u002F) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fcrewai-flows) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fcrewai\u002Ffeature\u002Fshared_state) |\n\n### 🧩 第一方\n| 框架 | 状态 | AG-UI 资源 |\n| ---------- | ------- | ---------------- |\n| [Microsoft Agent Framework](https:\u002F\u002Fazure.microsoft.com\u002Fen-us\u002Fblog\u002Fintroducing-microsoft-agent-framework\u002F) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fmicrosoft-agent-framework) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fmicrosoft-agent-framework-dotnet\u002Ffeature\u002Fshared_state) |\n| [Google ADK](https:\u002F\u002Fgoogle.github.io\u002Fadk-docs\u002Fget-started\u002F) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fadk) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fadk-middleware\u002Ffeature\u002Fshared_state?openCopilot=true) |\n| [AWS Strands Agents](https:\u002F\u002Fgithub.com\u002Fstrands-agents\u002Fsdk-python) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Faws-strands) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Faws-strands\u002Ffeature\u002Fshared_state) |\n| [AWS Bedrock AgentCore](https:\u002F\u002Fdocs.aws.amazon.com\u002Fbedrock-agentcore\u002Flatest\u002Fdevguide\u002Fruntime-agui-protocol-contract.html) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fgithub.com\u002Fawslabs\u002Ffullstack-solution-template-for-agentcore) |\n| [Mastra](https:\u002F\u002Fmastra.ai\u002F) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fmastra\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fmastra\u002Ffeature\u002Ftool_based_generative_ui) |\n| [Pydantic AI](https:\u002F\u002Fgithub.com\u002Fpydantic\u002Fpydantic-ai) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fpydantic-ai\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fpydantic-ai\u002Ffeature\u002Fshared_state) |\n| [Agno](https:\u002F\u002Fgithub.com\u002Fagno-agi\u002Fagno) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fagno\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fagno\u002Ffeature\u002Ftool_based_generative_ui) |\n| [LlamaIndex](https:\u002F\u002Fgithub.com\u002Frun-llama\u002Fllama_index) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fllamaindex\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fllamaindex\u002Ffeature\u002Fshared_state) |\n| [AG2](https:\u002F\u002Fag2.ai\u002F) | ✅ 支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fag2\u002F) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fag2\u002Ffeature\u002Fshared_state) |\n| [AWS Bedrock Agents](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002Fagents\u002F) | 🛠️ 进行中 | – |\n\n### 🌐 社区\n| 框架 | 状态 | AG-UI 资源 |\n| ---------- | ------- | ---------------- |\n| [Langroid](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fintegrations\u002Flangroid) | ✅ 已支持 | 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Flangroid\u002Ffeature\u002Fshared_state) |\n| [OpenAI Agent SDK](https:\u002F\u002Fopenai.github.io\u002Fopenai-agents-python\u002F) | 🛠️ 进行中 | – |\n| [Cloudflare Agents](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F) | 🛠️ 进行中 | – |\n\n\n## 代理交互协议\n\n| 协议 | 状态 | AG-UI 资源 | 集成 |\n| ---------- | ------- | ---------------- | ------------- |\n| [A2A]() | ✅ 已支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fa2a-protocol) | 合作伙伴 |\n\n\n## 基础设施 \u002F 部署\n| 平台 | 状态 | AG-UI 资源 | 集成 |\n| ---------- | ------- | ---------------- | ------------- |\n| [Amazon Bedrock AgentCore](https:\u002F\u002Faws.amazon.com\u002Fbedrock\u002Fagentcore\u002F) | ✅ 已支持 | ➡️ [文档](https:\u002F\u002Fdocs.aws.amazon.com\u002Fbedrock-agentcore\u002Flatest\u002Fdevguide\u002Fruntime-agui.html) | 第一方 |\n\n\n## 规范（标准）\n| 框架 | 状态 | AG-UI 资源 |\n| ---------- | ------- | ---------------- |\n| [Oracle Agent Spec](http:\u002F\u002Foracle.github.io\u002Fagent-spec\u002F) | ✅ 已支持 | ➡️ [文档](https:\u002F\u002Fgo.copilotkit.ai\u002Fcopilotkit-oracle-docs) 🎮 [演示](https:\u002F\u002Fdojo.ag-ui.com\u002Fagent-spec-langgraph\u002Ffeature\u002Ftool_based_generative_ui) |\n\n## 生成式 UI\n| 框架 | 状态 | AG-UI 资源 |\n| ---------- | ------- | ---------------- |\n| [MCP Apps](https:\u002F\u002Fblog.modelcontextprotocol.io\u002Fposts\u002F2025-11-21-mcp-apps\u002F) | ✅ 已支持 | ➡️ [文档](https:\u002F\u002Fdocs.copilotkit.ai\u002Fgenerative-ui-specs\u002Fmcp-apps) 🎮 [演示]() |\n\n\n## SDKs\n\n| SDK | 状态 | AG-UI 资源 | 集成 |\n| --- | ------- | ---------------- | ------------- |\n| [Kotlin]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fkotlin\u002Foverview.mdx) | 社区 |\n| [Golang]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fgo\u002Foverview.mdx) | 社区 |\n| [Dart]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Fdart) | 社区 |\n| [Java]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002Fdocs\u002Fsdk\u002Fjava\u002Foverview.mdx) | 社区 |\n| [Rust]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Frust\u002Fcrates\u002Fag-ui-client) | 社区 |\n| [Ruby]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fsdks\u002Fcommunity\u002Fruby) | 社区 |\n| [.NET]() | 🛠️ 进行中 | ➡️ [PR](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fpull\u002F38) | 社区 |\n| [Nim]() | 🛠️ 进行中 | ➡️ [PR](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fpull\u002F29) | 社区 |\n| [Flowise]() | 🛠️ 进行中 | ➡️ [GitHub 源](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F367) | 社区 |\n| [Langflow]() | 🛠️ 进行中 | ➡️ [GitHub 源](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F366) | 社区 |\n| [C++]() | 🛠️ 进行中 | ➡️ [GitHub 源](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F1108) | 社区 |\n\n## 客户端\n\n| 客户端 | 状态 | AG-UI 资源 | 集成 |\n| --- | ------- | ---------------- | ------------- |\n| [CopilotKit](https:\u002F\u002Fgithub.com\u002FCopilotKit\u002FCopilotKit) | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fdocs.copilotkit.ai\u002Fdirect-to-llm\u002Fguides\u002Fquickstart) | 第一方 |\n| [终端 + 代理]() | ✅ 已支持 | ➡️ [入门指南](https:\u002F\u002Fdocs.ag-ui.com\u002Fquickstart\u002Fclients) | 社区 |\n| [React Native]() | 🛠️ 招募帮助 | ➡️ [GitHub 源](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F510) | 社区 |\n\n[查看所有支持的集成 →](https:\u002F\u002Fdocs.ag-ui.com\u002Fintroduction#supported-integrations)\n\n## 示例\n### Hello World 应用\n\n视频：\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F18c03330-1ebc-4863-b2b8-cc6c3a4c7bae\n\nhttps:\u002F\u002Fagui-demo.vercel.app\u002F\n\n\n\n## AG-UI Dojo（构建模块查看器）\nAG-UI Dojo 通过简单而专注的示例展示了 AG-UI 的核心构建模块——每个示例仅包含 50 到 200 行代码。\n\n在此处查看 Dojo 及所有框架集成的源代码：[https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fapps\u002Fdojo](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Ftree\u002Fmain\u002Fapps\u002Fdojo)。\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fc298eea8-3f39-4a94-b968-7712429b0c49\n\n\n\n## 🙋🏽‍♂️ 贡献 AG-UI\n\n请参阅 [贡献指南](https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fblob\u002Fmain\u002FCONTRIBUTING.md)\n\n- **[双周 AG-UI 工作组](https:\u002F\u002Flu.ma\u002FCopilotKit?k=c)**\n  📅 请关注 CopilotKit Luma 活动日历\n\n## 路线图\n\n请查看 [AG-UI 路线图](https:\u002F\u002Fgithub.com\u002Forgs\u002Fag-ui-protocol\u002Fprojects\u002F1) 以了解当前正在开发的内容以及您可以参与的地方。\n\n\n## 📄 许可证\n\nAG-UI 是开源软件，采用 [MIT 许可证](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)。","# AG-UI 快速上手指南\n\nAG-UI 是一个开放、轻量级且基于事件的协议，旨在标准化 AI 智能体（Agent）与用户界面（UI）之间的连接。它支持实时流式聊天、双向状态同步、生成式 UI 以及人机协作等功能，并兼容 LangGraph、CrewAI、Microsoft Agent Framework 等多种主流框架。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Windows, macOS 或 Linux\n*   **Node.js**：建议安装 LTS 版本 (v18 或更高)\n*   **包管理器**：npm, yarn 或 pnpm\n*   **前置知识**：了解基本的 JavaScript\u002FTypeScript 或您所选用的后端框架（如 Python\u002FLangGraph 等）\n\n> **注意**：目前官方未提供特定的中国镜像源配置，建议使用国内通用的 npm 镜像（如淘宝镜像）加速依赖安装：\n> ```bash\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\nAG-UI 提供了命令行工具，可帮助您在一分钟内初始化项目。\n\n1.  **创建新项目**\n    在终端中运行以下命令，将 `my-agent-app` 替换为您想要的项目名称：\n\n    ```bash\n    npx create-ag-ui-app my-agent-app\n    ```\n\n2.  **进入项目目录**\n\n    ```bash\n    cd my-agent-app\n    ```\n\n3.  **安装依赖并启动**\n    根据提示选择您需要的模板（通常包含前端和后端示例），然后运行：\n\n    ```bash\n    npm install\n    npm run dev\n    ```\n\n## 基本使用\n\nAG-UI 的核心在于通过标准事件类型连接后端智能体与前端应用。以下是一个最简化的概念流程示例。\n\n### 1. 后端：发射事件 (Emit Events)\n在后端（例如使用 LangGraph 或原生 Node.js），智能体在执行过程中发射符合 AG-UI 标准的事件。\n\n```typescript\n\u002F\u002F 伪代码示例：后端发射一个文本消息事件\ncontext.emitEvent({\n  type: \"text-message-start\",\n  payload: {\n    messageId: \"msg_123\",\n    role: \"assistant\",\n    content: \"正在为您查询...\"\n  }\n});\n\n\u002F\u002F 发射流式内容\ncontext.emitEvent({\n  type: \"text-message-delta\",\n  payload: {\n    messageId: \"msg_123\",\n    delta: \"今天天气不错，适合外出。\"\n  }\n});\n```\n\n### 2. 前端：接收并渲染 (Connect & Render)\n在前端应用中，使用 AG-UI 客户端连接到后端服务，自动处理流式更新和状态同步。\n\n```tsx\n\u002F\u002F React 组件示例\nimport { useCopilotChat } from \"@copilotkit\u002Freact-core\"; \u002F\u002F 或使用 ag-ui 通用客户端\n\nexport function ChatInterface() {\n  const { messages, appendMessage } = useCopilotChat();\n\n  return (\n    \u003Cdiv className=\"chat-container\">\n      {messages.map((msg) => (\n        \u003Cdiv key={msg.id} className={`message ${msg.role}`}>\n          {msg.content}\n        \u003C\u002Fdiv>\n      ))}\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n### 3. 运行效果\n启动应用后，您将看到：\n*   **实时流式响应**：AI 的回答逐字显示，无需等待完整生成。\n*   **状态同步**：前端自动反映后端的思考过程或工具调用状态。\n*   **扩展性**：可根据需要集成生成式 UI 组件或人工介入环节。\n\n更多详细的功能演示和框架集成代码，请访问 [AG-UI Dojo](https:\u002F\u002Fdojo.ag-ui.com\u002F) 查看针对特定框架（如 LangGraph, CrewAI, Mastra 等）的完整示例。","某电商平台的开发团队正在构建一个智能客服系统，需要让后端 AI 代理实时响应用户查询并动态生成订单卡片等交互界面。\n\n### 没有 ag-ui 时\n- **通信协议混乱**：前端与不同框架（如 LangGraph、CrewAI）编写的后端代理之间缺乏统一标准，需为每种代理定制复杂的 WebSocket 或 SSE 解析逻辑。\n- **状态同步困难**：代理执行过程中的中间状态（如“正在查询库存”）难以实时推送到前端，导致用户界面长时间无反馈，体验割裂。\n- **交互形式单一**：仅能返回纯文本消息，无法让代理直接触发前端的富组件（如商品卡片、支付按钮），限制了业务转化能力。\n- **上下文传递繁琐**：将用户的实时操作上下文（如当前浏览的商品页）传递给代理需要手动封装大量冗余代码，维护成本极高。\n\n### 使用 ag-ui 后\n- **协议标准化**：ag-ui 提供统一的事件协议，无论后端使用何种代理框架，前端只需接入一次即可无缝兼容，大幅降低集成复杂度。\n- **实时双向同步**：利用 ag-ui 的事件流机制，代理的执行步骤和思考过程能实时映射到前端进度条或日志区，实现流畅的“人机协作”体验。\n- **生成式 UI 支持**：通过 ag-ui 的结构化消息类型，代理可直接指令前端渲染动态组件（如订单确认卡片），让对话即操作，提升转化率。\n- **上下文自动增强**：ag-ui 内置的中间件层自动处理用户上下文注入，开发者无需重复造轮子，即可让代理基于用户当前行为做出精准回应。\n\nag-ui 通过标准化的事件协议打破了代理与前端应用的壁垒，让复杂的 AI 交互像调用普通 API 一样简单高效。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fag-ui-protocol_ag-ui_7d06a054.png","ag-ui-protocol","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fag-ui-protocol_c46ca944.png",null,"https:\u002F\u002Fgithub.com\u002Fag-ui-protocol",[77,81,85,89,93,97,101,105,109,113],{"name":78,"color":79,"percentage":80},"Python","#3572A5",30.2,{"name":82,"color":83,"percentage":84},"TypeScript","#3178c6",29.4,{"name":86,"color":87,"percentage":88},"Kotlin","#A97BFF",10.4,{"name":90,"color":91,"percentage":92},"Java","#b07219",6.7,{"name":94,"color":95,"percentage":96},"Go","#00ADD8",6.1,{"name":98,"color":99,"percentage":100},"C++","#f34b7d",6,{"name":102,"color":103,"percentage":104},"Dart","#00B4AB",4.9,{"name":106,"color":107,"percentage":108},"Rust","#dea584",1.9,{"name":110,"color":111,"percentage":112},"Ruby","#701516",1.7,{"name":114,"color":115,"percentage":116},"CSS","#663399",0.7,12830,1160,"2026-04-06T17:43:52","MIT","","未说明",{"notes":124,"python":122,"dependencies":125},"AG-UI 是一个基于事件的协议而非独立的 AI 模型，因此没有特定的 GPU、内存或 Python 版本硬性要求。它主要通过 npm (Node.js) 进行安装 (npx create-ag-ui-app)，支持多种编程语言 SDK (Kotlin, Go, Dart, Java, Rust, Ruby 等)。其运行环境取决于所集成的具体后端框架（如 LangGraph, CrewAI, Microsoft Agent Framework 等）和前端应用的技术栈。支持任何事件传输方式（SSE, WebSockets, webhooks 等）。",[126],"@ag-ui\u002Fcore",[13],[72,129,130,131,132],"agent-frontend","agent-ui","agentic-workflow","ai-agents","2026-03-27T02:49:30.150509","2026-04-07T06:14:04.092772",[136,141,146,151,156],{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},21198,"为什么前端工具调用结果（pending_tool_calls）没有被正确记录到 ADK 会话数据库中？","这是一个已知的中间件 Bug。具体表现为：中间件在检测到工具结果提交后，会错误地将 `FunctionResponse` 持久化两次，且第二次持久化的 `invocation_id` 可能不正确，导致 `pending_tool_calls` 无法被清理。该问题已被追踪（Issue #1074），修复代码已在 PR #1075 中处理。建议关注相关 PR 的合并进度以获取修复版本。","https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F568",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},21199,"AG-UI 是否支持 PydanticAI？","是的，支持正在开发中。基于新的 PydanticAI 工具集支持的 PR（pydantic-ai#2101）已经脱离草稿状态并经过审查。目前的实现逻辑是：只有当 AG-UI 客户端收到 `RunFinished` 事件且没有给定工具的结果时，才会开始处理工具调用，因此集成后应能正常工作。","https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F5",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},21200,"ag-ui-adk 是否支持通过线程 ID（thread id）获取消息历史？","目前 `ag-ui-adk` 集成不直接支持按线程 ID 拉取历史消息。由于消息历史可能非常庞大，且为了保持协议通用性，目前的变通方法是：触发一个空的 agent 运行（empty agent run），这会促使系统发送 `MessagesSnapshotEvent` 事件，从而在每次运行结束时返回完整的消息快照。未来可能会考虑添加分页功能以避免一次性传输大量数据。","https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F640",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},21201,"如何集成 MCP-UI 以在 AG-UI 中渲染交互式界面？","MCP Apps 中间件已经完成并合并。该功能允许 Agent 发送 `UIResource` 负载（包含表单或远程 DOM 片段等结构化 UI 内容），AG-UI 客户端将其作为 `Activity Message` 接收并直接渲染。当 MCP 更新资源时，AG-UI 会流式传输增量更新以保持界面实时同步。您可以查看 `middlewares\u002Fmcp-apps-middleware` 目录下的代码进行集成。","https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F619",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},21202,"使用 Claude Sonnet 4 模型时，ADK 中间件为何没有返回响应内容？","这是版本 0.3.2 中的一个已知问题，导致特定模型（如 `claude-sonnet-4@20250514`）的响应消失。维护者确认了该问题，建议暂时回滚到该版本之前的提交（commit）以恢复正常功能，直到官方发布修复补丁。","https:\u002F\u002Fgithub.com\u002Fag-ui-protocol\u002Fag-ui\u002Fissues\u002F400",[162,167],{"id":163,"version":164,"summary_zh":165,"released_at":166},127210,"release\u002F2026-04-06","## 已发布的软件包\n### Python (PyPI) — 发布于 UTC 16:04:06\n| 软件包 | 版本 | 安装命令 |\n|---------|---------|--------|\n| ag_ui_adk | 0.6.0 | `pip install ag_ui_adk==0.6.0` |\n\n","2026-04-06T16:04:06",{"id":168,"version":169,"summary_zh":170,"released_at":171},127211,"release\u002F2026-03-28","## 已发布的软件包\n### Python (PyPI) — 发布于 UTC 05:46:11\n| 软件包 | 版本 | 安装命令 |\n|---------|---------|--------|\n| ag-ui-agent-spec | 0.1.0 | `pip install ag-ui-agent-spec==0.1.0` |\n| ag_ui_adk | 0.5.2 | `pip install ag_ui_adk==0.5.2` |\n| ag-ui-claude-sdk | 0.1.0 | `pip install ag-ui-claude-sdk==0.1.0` |\n| ag_ui_langroid | 0.1.0 | `pip install ag_ui_langroid==0.1.0` |\n\n","2026-03-28T05:46:12"]