{"id":15039262,"url":"https://github.com/composiohq/composio","last_synced_at":"2026-04-14T01:02:56.298Z","repository":{"id":231139509,"uuid":"762304524","full_name":"ComposioHQ/composio","owner":"ComposioHQ","description":"Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.","archived":false,"fork":false,"pushed_at":"2026-02-27T00:48:49.000Z","size":296961,"stargazers_count":27201,"open_issues_count":50,"forks_count":4457,"subscribers_count":61,"default_branch":"next","last_synced_at":"2026-02-27T05:03:01.318Z","etag":null,"topics":["agentic-ai","agents","ai","ai-agents","aiagents","developer-tools","function-calling","gpt-4","javascript","js","llm","llmops","mcp","python","remote-mcp-server","sse","typescript"],"latest_commit_sha":null,"homepage":"https://docs.composio.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ComposioHQ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-02-23T13:58:27.000Z","updated_at":"2026-02-27T05:00:29.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":892,"template":false,"template_full_name":null,"purl":"pkg:github/ComposioHQ/composio","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/next","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ComposioHQ%2Fcomposio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30071895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T03:25:38.285Z","status":"ssl_error","status_checked_at":"2026-03-04T03:25:05.086Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["agentic-ai","agents","ai","ai-agents","aiagents","developer-tools","function-calling","gpt-4","javascript","js","llm","llmops","mcp","python","remote-mcp-server","sse","typescript"],"created_at":"2024-09-24T20:42:07.310Z","updated_at":"2026-03-04T05:00:59.992Z","avatar_url":"https://github.com/ComposioHQ.png","language":"TypeScript","readme":"\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/ComposioHQ/composio/next/public/cover.png\" alt=\"Composio Logo\" width=\"auto\" height=\"auto\" style=\"margin-bottom: 20px;\"/\u003e\n\n\n# Composio SDK\n\nSkills that evolve for your Agents\n\n[🌐 Website](https://composio.dev) • [📚 Documentation](https://docs.composio.dev)\n\n[![GitHub Stars](https://img.shields.io/github/stars/ComposioHQ/composio?style=social)](https://github.com/ComposioHQ/composio/stargazers)\n[![PyPI Downloads](https://img.shields.io/pypi/dm/composio?label=PyPI%20Downloads)](https://pypi.org/project/composio/)\n[![NPM Downloads](https://img.shields.io/npm/dt/@composio/core?label=NPM%20Downloads)](https://www.npmjs.com/package/@composio/core)\n[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord\u0026logoColor=white)](https://discord.gg/composio)\n\u003c/div\u003e\n\nThis repository contains the official Software Development Kits (SDKs) for Composio, providing seamless integration capabilities for Python and Typescript Agentic Frameworks and Libraries.\n\n## Getting Started\n\n### TypeScript SDK Installation\n\n```bash\n# Using npm\nnpm install @composio/core\n\n# Using yarn\nyarn add @composio/core\n\n# Using pnpm\npnpm add @composio/core\n```\n\n#### Quick start:\n\n```typescript\nimport { Composio } from '@composio/core';\n// Initialize the SDK\nconst composio = new Composio({\n  // apiKey: 'your-api-key',\n});\n```\n\n#### Simple Agent with OpenAI Agents\n\n```bash\nnpm install @composio/openai-agents @openai/agents\n```\n\n```typescript\nimport { Composio } from '@composio/core';\nimport { OpenAIAgentsProvider } from '@composio/openai-agents';\nimport { Agent, run } from '@openai/agents';\n\nconst composio = new Composio({\n  provider: new OpenAIAgentsProvider(),\n});\n\nconst userId = 'user@acme.org';\n\nconst tools = await composio.tools.get(userId, {\n  toolkits: ['HACKERNEWS'],\n});\n\nconst agent = new Agent({\n  name: 'Hackernews assistant',\n  tools: tools,\n});\n\nconst result = await run(agent, 'What is the latest hackernews post about?');\n\nconsole.log(JSON.stringify(result.finalOutput, null, 2));\n// will return the response from the agent with data from HACKERNEWS API.\n```\n\n### Python SDK Installation\n\n```bash\n# Using pip\npip install composio\n\n# Using poetry\npoetry add composio\n```\n\n#### Quick start:\n\n```python\nfrom composio import Composio\n\ncomposio = Composio(\n  # api_key=\"your-api-key\",\n)\n```\n\n#### Simple Agent with OpenAI Agents\n\n```bash\npip install composio_openai_agents openai-agents\n```\n\n```python\nimport asyncio\nfrom agents import Agent, Runner\nfrom composio import Composio\nfrom composio_openai_agents import OpenAIAgentsProvider\n\n# Initialize Composio client with OpenAI Agents Provider\ncomposio = Composio(provider=OpenAIAgentsProvider())\n\nuser_id = \"user@acme.org\"\ntools = composio.tools.get(user_id=user_id, toolkits=[\"HACKERNEWS\"])\n\n# Create an agent with the tools\nagent = Agent(\n    name=\"Hackernews Agent\",\n    instructions=\"You are a helpful assistant.\",\n    tools=tools,\n)\n\n# Run the agent\nasync def main():\n    result = await Runner.run(\n        starting_agent=agent,\n        input=\"What's the latest Hackernews post about?\",\n    )\n    print(result.final_output)\n\nasyncio.run(main())\n# will return the response from the agent with data from HACKERNEWS API.\n```\n\nFor more detailed usage instructions and examples, please refer to each SDK's specific documentation.\n\n### Open API Specification\n\nTo update the OpenAPI specifications used for generating SDK documentation:\n\n```bash\n# Pull the latest API specifications from the backend\npnpm api:pull\n```\n\nThis command pulls the OpenAPI specification from `https://backend.composio.dev/api/v3/openapi.json` and updates the local API documentation files.\n\nThis is pulled automatically with build step.\n\n## Available SDKs\n\n### TypeScript SDK (/ts)\n\nThe TypeScript SDK provides a modern, type-safe way to interact with Composio's services. It's designed for both Node.js and browser environments, offering full TypeScript support with comprehensive type definitions.\n\nFor detailed information about the TypeScript SDK, please refer to the [TypeScript SDK Documentation](/ts/README.md).\n\n### Python SDK (/python)\n\nThe Python SDK offers a Pythonic interface to Composio's services, making it easy to integrate Composio into your Python applications. It supports Python 3.10+ and follows modern Python development practices.\n\nFor detailed information about the Python SDK, please refer to the [Python SDK Documentation](/python/README.md).\n\n## Provider Support\n\nThe following table shows which AI frameworks and platforms are supported in each SDK:\n\n| Provider | TypeScript | Python |\n|----------|:----------:|:------:|\n| OpenAI | ✅ | ✅ |\n| OpenAI Agents | ✅ | ✅ |\n| Anthropic | ✅ | ✅ |\n| LangChain | ✅ | ✅ |\n| LangGraph | ✅* | ✅ |\n| LlamaIndex | ✅ | ✅ |\n| Vercel AI SDK | ✅ | ❌ |\n| Google Gemini | ✅ | ✅ |\n| Google ADK | ❌ | ✅ |\n| Mastra | ✅ | ❌ |\n| Cloudflare Workers AI | ✅ | ❌ |\n| CrewAI | ❌ | ✅ |\n| AutoGen | ❌ | ✅ |\n\n\\* *LangGraph in TypeScript is supported via the `@composio/langchain` package.*\n\n\u003e **Don't see your provider?** Learn how to [build a custom provider](https://docs.composio.dev/sdk/typescript/custom-providers) to integrate with any AI framework.\n\n## Packages\n\n### Core Packages\n\n| Package | Version |\n|---------|---------|\n| **TypeScript** | |\n| [@composio/core](https://www.npmjs.com/package/@composio/core) | ![npm version](https://img.shields.io/npm/v/@composio/core) |\n| **Python** | |\n| [composio](https://pypi.org/project/composio/) | ![PyPI version](https://img.shields.io/pypi/v/composio) |\n\n### Provider Packages\n\n| Package | Version |\n|---------|---------|\n| **TypeScript** | |\n| [@composio/openai](https://www.npmjs.com/package/@composio/openai) | ![npm version](https://img.shields.io/npm/v/@composio/openai) |\n| [@composio/openai-agents](https://www.npmjs.com/package/@composio/openai-agents) | ![npm version](https://img.shields.io/npm/v/@composio/openai-agents) |\n| [@composio/anthropic](https://www.npmjs.com/package/@composio/anthropic) | ![npm version](https://img.shields.io/npm/v/@composio/anthropic) |\n| [@composio/langchain](https://www.npmjs.com/package/@composio/langchain) | ![npm version](https://img.shields.io/npm/v/@composio/langchain) |\n| [@composio/llamaindex](https://www.npmjs.com/package/@composio/llamaindex) | ![npm version](https://img.shields.io/npm/v/@composio/llamaindex) |\n| [@composio/vercel](https://www.npmjs.com/package/@composio/vercel) | ![npm version](https://img.shields.io/npm/v/@composio/vercel) |\n| [@composio/google](https://www.npmjs.com/package/@composio/google) | ![npm version](https://img.shields.io/npm/v/@composio/google) |\n| [@composio/mastra](https://www.npmjs.com/package/@composio/mastra) | ![npm version](https://img.shields.io/npm/v/@composio/mastra) |\n| [@composio/cloudflare](https://www.npmjs.com/package/@composio/cloudflare) | ![npm version](https://img.shields.io/npm/v/@composio/cloudflare) |\n| **Python** | |\n| [composio-openai](https://pypi.org/project/composio-openai/) | ![PyPI version](https://img.shields.io/pypi/v/composio-openai) |\n| [composio-openai-agents](https://pypi.org/project/composio-openai-agents/) | ![PyPI version](https://img.shields.io/pypi/v/composio-openai-agents) |\n| [composio-anthropic](https://pypi.org/project/composio-anthropic/) | ![PyPI version](https://img.shields.io/pypi/v/composio-anthropic) |\n| [composio-langchain](https://pypi.org/project/composio-langchain/) | ![PyPI version](https://img.shields.io/pypi/v/composio-langchain) |\n| [composio-langgraph](https://pypi.org/project/composio-langgraph/) | ![PyPI version](https://img.shields.io/pypi/v/composio-langgraph) |\n| [composio-llamaindex](https://pypi.org/project/composio-llamaindex/) | ![PyPI version](https://img.shields.io/pypi/v/composio-llamaindex) |\n| [composio-crewai](https://pypi.org/project/composio-crewai/) | ![PyPI version](https://img.shields.io/pypi/v/composio-crewai) |\n| [composio-autogen](https://pypi.org/project/composio-autogen/) | ![PyPI version](https://img.shields.io/pypi/v/composio-autogen) |\n| [composio-gemini](https://pypi.org/project/composio-gemini/) | ![PyPI version](https://img.shields.io/pypi/v/composio-gemini) |\n| [composio-google](https://pypi.org/project/composio-google/) | ![PyPI version](https://img.shields.io/pypi/v/composio-google) |\n| [composio-google-adk](https://pypi.org/project/composio-google-adk/) | ![PyPI version](https://img.shields.io/pypi/v/composio-google-adk) |\n\n### Utility Packages\n\n| Package | Version |\n|---------|---------|\n| [@composio/json-schema-to-zod](https://www.npmjs.com/package/@composio/json-schema-to-zod) | ![npm version](https://img.shields.io/npm/v/@composio/json-schema-to-zod) |\n| [@composio/ts-builders](https://www.npmjs.com/package/@composio/ts-builders) | ![npm version](https://img.shields.io/npm/v/@composio/ts-builders) |\n\n_if you are looking for the older sdk, you can find them [here](https://github.com/ComposioHQ/composio/tree/master)_\n\n## Rube\n\n[Rube](https://rube.app) is a Model Context Protocol (MCP) server built with Composio. It connects your AI tools to 500+ apps like Gmail, Slack, GitHub, and Notion. Simply install it in your AI client, authenticate once with your apps, and start asking your AI to perform real actions like \"Send an email\" or \"Create a task.\" \n\nIt integrates with major AI clients like Cursor, Claude Desktop, VS Code, Claude Code and any custom MCP‑compatible client. You can switch between these clients and your integrations follow you.\n\n\n## Contributing\n\nWe welcome contributions to both SDKs! Please read our [contribution guidelines](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md) before submitting pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Support\n\nIf you encounter any issues or have questions about the SDKs:\n\n- Open an issue in this repository\n- Contact our [support team](mailto:support@composio.dev)\n- Check our [documentation](https://docs.composio.dev/)\n","funding_links":[],"categories":["Tools and Code"],"sub_categories":["Agent Frameworks"],"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"}