{"id":13455911,"url":"https://github.com/ComposioHQ/composio","last_synced_at":"2025-03-24T09:31:02.580Z","repository":{"id":231139509,"uuid":"762304524","full_name":"ComposioHQ/composio","owner":"ComposioHQ","description":"Composio equip's your AI agents \u0026 LLMs with 100+ high-quality integrations via function calling","archived":false,"fork":false,"pushed_at":"2025-03-17T09:35:43.000Z","size":926034,"stargazers_count":24346,"open_issues_count":53,"forks_count":4371,"subscribers_count":48,"default_branch":"master","last_synced_at":"2025-03-18T01:18:52.606Z","etag":null,"topics":["agents","ai","ai-agents","aiagents","developer-tools","function-calling","gpt-4","gpt-4o","hacktoberfest","hacktoberfest2024","javascript","js","llm","llmops","python","typescript"],"latest_commit_sha":null,"homepage":"https://docs.composio.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ComposioHQ.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.MD","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-23T13:58:27.000Z","updated_at":"2025-03-18T01:11:41.000Z","dependencies_parsed_at":"2024-04-02T17:06:14.078Z","dependency_job_id":"8a037cab-cd5c-4842-857c-19754235cea7","html_url":"https://github.com/ComposioHQ/composio","commit_stats":{"total_commits":2136,"total_committers":49,"mean_commits":43.59183673469388,"dds":0.8127340823970037,"last_synced_commit":"5f53b74b333de6efb6bccf1368920cee9d43c025"},"previous_names":["samparkai/composio_sdk","samparkai/composio","composiodev/composio","composiohq/composio"],"tags_count":148,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ComposioHQ%2Fcomposio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ComposioHQ%2Fcomposio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ComposioHQ%2Fcomposio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ComposioHQ%2Fcomposio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ComposioHQ","download_url":"https://codeload.github.com/ComposioHQ/composio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245243172,"owners_count":20583576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","ai-agents","aiagents","developer-tools","function-calling","gpt-4","gpt-4o","hacktoberfest","hacktoberfest2024","javascript","js","llm","llmops","python","typescript"],"created_at":"2024-07-31T08:01:13.371Z","updated_at":"2025-03-24T09:30:57.571Z","avatar_url":"https://github.com/ComposioHQ.png","language":"Python","readme":"\u003cp\u003e\n  \u003ca href=\"https://github.com/composiohq/composio/blob/master/README.md\"\u003eEN\u003c/a\u003e | \u003ca href=\"https://github.com/composiohq/composio/blob/master/README-CN.md\"\u003eCN\u003c/a\u003e | \u003ca href=\"https://github.com/composiohq/composio/blob/master/README-JP.md\"\u003eJP\u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://composio.dev//#gh-dark-mode-only\"\u003e\n    \u003cimg src=\"./python/docs/imgs/composio_white_font.svg\" width=\"318px\" alt=\"Composio 标志\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://composio.dev//#gh-light-mode-only\"\u003e\n    \u003cimg src=\"./python/docs/imgs/composio_black_font.svg\" width=\"318px\" alt=\"Composio 标志\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/composiodev/composio/actions/workflows/common.yml\"\u003e\n  \u003cimg alt=\"测试\" src=\"https://img.shields.io/github/actions/workflow/status/composiodev/composio/common.yml?label=Tests\u0026style=plastic\u0026logo=github\u0026color=blue\u0026cacheSeconds=60\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/composio-core/\"\u003e\n  \u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/composio_core?label=最新版本\u0026style=plastic\u0026logo=pypi\u0026color=blue\u0026cacheSeconds=60\u0026logoColor=white\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/composio-core/\"\u003e\n  \u003cimg alt=\"下载量\" src=\"https://img.shields.io/pypi/dm/composio-core?label=下载量\u0026style=plastic\u0026logo=github\u0026color=blue\u0026cacheSeconds=60\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003e\u003ci\u003e\n  面向 AI 代理的生产就绪型工具集\n\u003c/i\u003e\u003c/h2\u003e\n\n\u003ch4 align=\"center\"\u003e只需一行代码，即可为您的代理配备高质量的工具和集成，无需担心身份验证、准确性和可靠性！\n\u003c/h4\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cp\u003e\n\u003ca href=\"https://docs.composio.dev\" rel=\"dofollow\"\u003e\u003cstrong\u003e探索文档 »\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n\u003ca href=\"https://app.composio.dev\"\u003e在仪表板上试用\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n\u003ca href=\"https://www.composio.dev\"\u003e主页\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n\u003ca href=\"https://docs.composio.dev/sdk\"\u003eSDK\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n\u003ca href=\"https://docs.composio.dev/api-reference/\"\u003eAPIs\u003c/a\u003e \n\u003c/p\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\u003cdiv align=\"center\"\u003e\n\u003cp \u003e\n    \u003cb\u003e✨ 社交媒体 \u003e\u003e\u003c/b\u003e\n    \u003ca href=\"https://dub.composio.dev/JoinHQ\"\u003eDiscord\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n    \u003ca href=\"https://www.youtube.com/@Composio\"\u003eYoutube\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n    \u003ca href=\"https://twitter.com/composiohq\"\u003eTwitter\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n    \u003ca href=\"https://www.linkedin.com/company/composio-dev\"\u003eLinkedIn\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003cb\u003e⛏️ 贡献 \u003e\u003e\u003c/b\u003e\n    \u003ca href=\"https://github.com/composiodev/composio/issues/new?assignees=\u0026labels=type%3A+bug\u0026template=bug_report.yml\u0026title=%F0%9F%90%9B+Bug+Report%3A+\"\u003e报告错误\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n    \u003ca href=\"https://github.com/composiodev/composio/issues/new?assignees=\u0026labels=feature\u0026template=feature_request.yml\u0026title=%F0%9F%9A%80+Feature%3A+\"\u003e请求功能\u003c/a\u003e \u003cb\u003e|\u003c/b\u003e\n    \u003ca href=\"https://github.com/composiodev/composio/blob/master/CONTRIBUTING.md\"\u003e参与贡献\u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\n## 📋 目录\n\n- [📋 目录](#-目录)\n- [🤔 为什么选择 Composio？](#-为什么选择-composio)\n- [🔥 主要特性](#-主要特性)\n- [🚀 Python 快速入门](#-python-快速入门)\n  - [1. 安装](#1-安装)\n  - [2. Composio 实战测试](#2-composio-实战测试)\n- [🚀 Javascript 快速入门](#-javascript-快速入门)\n  - [1. **安装 Composio SDK**：](#1-安装-composio-sdk)\n  - [2. **配置 OpenAI 和 Composio 工具集**：](#2-配置-openai-和-composio-工具集)\n  - [3. **运行您的脚本**：](#3-运行您的脚本)\n- [💡 示例](#-示例)\n  - [Python](#python)\n  - [Javascript](#javascript)\n- [Star 历史](#star-历史)\n- [📋 阅读我们的行为准则](#-阅读我们的行为准则)\n- [🤗 贡献](#-贡献)\n- [🔗 链接](#-链接)\n- [🛡️ 许可证](#️-许可证)\n- [💪 感谢所有贡献者](#-感谢所有贡献者)\n\n## 🤔 为什么选择 Composio？\n\n我们相信基于 AI 的代理/工作流是未来。\nComposio 是将 AI 代理集成到最佳代理工具并用它们完成任务的最佳工具集。\n\n\u003cimg alt=\"插图\" src=\"./python/docs/imgs/banner.gif\" style=\"border-radius: 5px\"/\u003e\n\n## 🔥 主要特性\n\n- **100+ 工具**：支持各种不同类别\n  - **软件**：在 GitHub、Notion、Linear、Gmail、Slack、Hubspot、Salesforce 等 90 多个平台上执行任何操作。\n  - **操作系统**：点击任意位置、输入任何内容、复制到剪贴板等。\n  - **浏览器**：智能搜索、截图、MultiOn、下载、上传等。\n  - **搜索**：Google 搜索、Perplexity 搜索、Tavily、Exa 等。 \n  - **软件工程**：Ngrok、数据库、Redis、Vercel、Git 等。\n  - **RAG**：即时为任何类型的数据提供代理 RAG！\n\n- **框架**：通过一行代码在 **OpenAI、Claude、LlamaIndex、Langchain、CrewAI、Autogen、Gemini、Julep、Lyzr** 等代理框架中使用工具。\n- **托管授权**：支持六种不同的身份验证协议。将 _Access Token、Refresh Token、OAuth、API Keys、JWT 等_ 抽象出来，让您专注于构建代理。\n- **准确性**：由于更好的工具设计，您的工具调用的 _代理准确性提高了 40%_。\n- **可嵌入**：在应用程序后端进行白标，为所有用户和代理管理身份验证和集成，保持一致的体验。\n- **可插拔**：设计为可轻松扩展其他工具、框架和身份验证协议。\n\n## 🚀 Python 快速入门\n\n### 1. 安装\n\n要开始使用，请在终端中键入以下命令。\n\n```bash\npip install composio-core\n```\n\n如果您想安装带有 openai 插件的 'composio' 包：`pip install composio-openai`。\n\n### 2. Composio 实战测试\n\n让我们使用 Composio 创建一个可以为 Github 仓库点赞的 AI 代理。\n\n```bash\ncomposio add github # 连接您的 Github - 在终端中运行\n```\n\n```python\nfrom openai import OpenAI\nfrom composio_openai import ComposioToolSet, App, Action\n\nopenai_client = OpenAI(\n    api_key=\"{{OPENAIKEY}}\"\n)\n\n# 初始化 Composio 工具集\n\ncomposio_tool_set = ComposioToolSet()\n\n# 获取预配置的 GitHub 工具\nactions = composio_tool_set.get_actions(\n    actions=[Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER]\n)\n\nmy_task = \"Star a repo composiodev/composio on GitHub\"\n\n# 设置 openai 助手\nassistant_instruction = \"You are a super intelligent personal assistant\"\n\nassistant = openai_client.beta.assistants.create(\n    name=\"Personal Assistant\",\n    instructions=assistant_instruction,\n    model=\"gpt-4-turbo\",\n    tools=actions,\n)\n\n# 创建线程\nthread = openai_client.beta.threads.create()\n\nmessage = openai_client.beta.threads.messages.create(\n    thread_id=thread.id,\n    role=\"user\",\n    content=my_task\n)\n\n# 使用集成执行代理\nrun = openai_client.beta.threads.runs.create(\n    thread_id=thread.id,\n    assistant_id=assistant.id\n)\n\n# 执行函数调用\nresponse_after_tool_calls = composio_tool_set.wait_and_handle_assistant_tool_calls(\n    client=openai_client,\n    run=run,\n    thread=thread,\n)\n\nprint(response_after_tool_calls)\n```\n\n## 🚀 Javascript 快速入门\n\n要在 Javascript 中开始使用 Composio SDK，请按照以下步骤操作：\n\n### 1. **安装 Composio SDK**：\n   ```bash\n   npm install composio-core\n   ```\n\n### 2. **配置 OpenAI 和 Composio 工具集**：\n   ```javascript\n   import { OpenAI } from \"openai\";\n   import { OpenAIToolSet } from \"composio-core\";\n\n   const toolset = new OpenAIToolSet({\n       apiKey: process.env.COMPOSIO_API_KEY,\n   });\n\n   async function setupUserConnectionIfNotExists(entityId) {\n       const entity = await toolset.client.getEntity(entityId);\n       const connection = await entity.getConnection('github');\n\n       if (!connection) {\n           // 如果此实体/用户尚未连接帐户\n           const connection = await entity.initiateConnection(appName);\n           console.log(\"通过以下方式登录: \", connection.redirectUrl);\n           return connection.waitUntilActive(60);\n       }\n\n       return connection;\n   }\n\n   async function executeAgent(entityName) {\n       const entity = await toolset.client.getEntity(entityName)\n       await setupUserConnectionIfNotExists(entity.id);\n\n       const tools = await toolset.get_actions({ actions: [\"github_issues_create\"] }, entity.id);\n       const instruction = \"Make an issue with sample title in the repo - himanshu-dixit/custom-repo-breaking\"\n\n       const client = new OpenAI({ apiKey: process.env.OPEN_AI_API_KEY })\n       const response = await client.chat.completions.create({\n           model: \"gpt-4-turbo\",\n           messages: [{\n               role: \"user\",\n               content: instruction,\n           }],\n           tools: tools,\n           tool_choice: \"auto\",\n       })\n\n       console.log(response.choices[0].message.tool_calls);\n       await toolset.handle_tool_call(response, entity.id);\n   }\n\n   executeAgent(\"your-entity-name\");\n   ```\n\n### 3. **运行您的脚本**：\n   ```bash\n   node your_script.js\n   ```\n\n这将设置 Composio SDK 并执行一个使用提供的说明创建 GitHub 问题的代理。\n\n有关更多详细信息，请参阅 [Composio SDK 文档](https://docs.composio.dev/)。\n\n## 💡 示例\n\n### [Python](https://docs.composio.dev/guides/python/)\n\n### [Javascript](https://docs.composio.dev/guides/javascript/)\n\n## Star 历史\n\n[![Star History Chart](https://api.star-history.com/svg?repos=composiohq/composio\u0026type=Date)](https://star-history.com/#composiohq/composio\u0026Date)\n\n## 📋 阅读我们的行为准则\n  \n作为我们开源社区的一部分，我们要求自己和其他贡献者遵守高标准的沟通。作为本项目的参与者和贡献者，您同意遵守我们的[行为准则](https://github.com/composiodev/composio/blob/master/CODE_OF_CONDUCT.md)。\n\n## 🤗 贡献\n\nComposio 是开源的，我们欢迎贡献。请 fork 存储库，为您的功能创建一个新分支，添加您的功能或改进，然后发送拉取请求。\n\n在开始之前，请先阅读我们的[贡献指南](https://github.com/composiodev/composio/blob/master/CONTRIBUTING.md)和[行为准则](https://github.com/composiodev/composio/blob/master/CODE_OF_CONDUCT.md)。\n\n## 🔗 链接\n\n- [主页](https://composio.dev?utm_campaign=github-readme) \n- [贡献指南](https://github.com/composiodev/composio/blob/master/CONTRIBUTING.md)\n- [文档](https://docs.composio.dev/?utm_campaign=github-readme)\n\n## 🛡️ 许可证\n\nComposio 采用 Elastic 许可证 - 有关详细信息，请参阅 [LICENSE](https://github.com/composiodev/composio/blob/master/LICENSE) 文件。\n\n## 💪 感谢所有贡献者\n\n\u003ca href=\"https://github.com/composiohq/composio/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=composiodev/composio\" alt=\"贡献者名单\"/\u003e\n\u003c/a\u003e\n","funding_links":[],"categories":["Agentic Frameworks","AI Agent Frameworks","TypeScript","Python","Applications","Repos","A01_文本生成_文本对话","📚 Projects (1974 total)","HarmonyOS","Agentic Framework","🌟 Core Frameworks","Frameworks","Table of Open-Source AI Agents Projects","\u003ca id=\"tools\"\u003e\u003c/a\u003e🛠️ Tools","ai","typescript","What's New","ツール","📋 Contents","Developer Tools and Automation","3）参考实现与开源工具（GitHub）","Platforms \u0026 Low-Code","Top 20 by Stars"],"sub_categories":["General Agent Frameworks","Advanced Components","大语言对话模型及数据","MCP Servers","Windows Manager","Bleeding Edge ⚗️","🆕 Recently Added (January 2026)","MCPサーバー \u0026 ツール","🤖 4. Agentic AI \u0026 Multi-Agent Systems","Integration and Extensions","AI Native 工具","Research Agents"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FComposioHQ%2Fcomposio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FComposioHQ%2Fcomposio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FComposioHQ%2Fcomposio/lists"}