Skip to main content

Core package to act as a bridge between composio platform and other services.

Project description

Composio logo Composio Logo

Tests PyPI Downloads

Production Ready Toolset for AI Agents

Equip your agent with high-quality tools & integrations without worrying about authentication, accuracy, and reliability in a single line of code!


✨ Socials >> Discord | Youtube | Twitter | Linkedin

⛏️ Contribute >> Report Bugs | Request Feature | Contribute

📋 Table of contents

🤔 Why Composio?

We believe AI Based Agents/Workflows are the future. Composio is the best toolset to integrate AI Agents to best Agentic Tools and use them to accomplish tasks.

Illustration

🔥 Key Features

  • 100+ Tools: Support for a range of different categories

    • Software: Do anything on GitHub, Notion, Linear, Gmail, Slack, Hubspot, Salesforce, & 90 more.
    • OS: Click anywhere, Type anything, Copy to Clipboard, & more.
    • Browser: Smart Search, Take a screenshot, MultiOn, Download, Upload, & more.
    • Search: Google Search, Perplexity Search, Tavily, Exa & more.
    • SWE: Ngrok, Database, Redis, Vercel, Git, etc.
    • RAG: Agentic RAG for any type of data on the fly!
  • Frameworks: Use tools with agent frameworks like OpenAI, Claude, LlamaIndex, Langchain, CrewAI, Autogen, Gemini, Julep, Lyzr, and more in a single line of code.

  • Managed Authorisation: Supports six different auth protocols. Access Token, Refresh token, OAuth, API Keys, JWT, and more abstracted out so you can focus on the building agents.

  • Accuracy: Get upto 40% better agentic accuracy in your tool calls due to better tool designs.

  • Embeddable: Whitelabel in the backend of your applications managing Auth & Integrations for all your users & agents and maintain a consistent experience.

  • Pluggable: Designed to be extended with additional Tools, Frameworks and Authorisation Protocols very easily.

🚀 Getting Started

1. Installation

To get started, type the following command in your Terminal.

pip install composio-core

If you want to install the 'composio' package along with its openai plugin: pip install composio-openai.

2. Testing Composio in Action

Let's use Composio to create an AI Agent that can star a Github Repo.

composio add github # Connect your Github - Run this in terminal
from openai import OpenAI
from composio_openai import ComposioToolSet, App, Action

openai_client = OpenAI(
    api_key="{{OPENAIKEY}}"
)

# Initialise the Composio Tool Set

composio_tool_set = ComposioToolSet()

# Get GitHub tools that are pre-configured
actions = composio_tool_set.get_actions(
    actions=[Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER]
)

my_task = "Star a repo composiodev/composio on GitHub"

# Setup openai assistant
assistant_instruction = "You are a super intelligent personal assistant"

assistant = openai_client.beta.assistants.create(
    name="Personal Assistant",
    instructions=assistant_instruction,
    model="gpt-4-turbo",
    tools=actions,
)

# create a thread
thread = openai_client.beta.threads.create()

message = openai_client.beta.threads.messages.create(
    thread_id=thread.id,
    role="user",
    content=my_task
)

# Execute Agent with integrations
run = openai_client.beta.threads.runs.create(
    thread_id=thread.id,
    assistant_id=assistant.id
)


# Execute Function calls
response_after_tool_calls = composio_tool_set.wait_and_handle_assistant_tool_calls(
    client=openai_client,
    run=run,
    thread=thread,
)

print(response_after_tool_calls)

💡 Examples

Competitor Researcher

Todolist to Calendar

Github to Trello

Star History

Star History Chart

📋 Read Our Code Of Conduct

As part of our open-source community, we hold ourselves and other contributors to a high standard of communication. As a participant and contributor to this project, you agree to abide by our Code of Conduct.

🤗 Contributions

Composio is open-source and we welcome contributions. Please fork the repository, create a new branch for your feature, add your feature or improvement, and send a pull request.

Also go through our Contribution Guidelines and Code of Conduct before you start.

🔗 Links

🛡️ License

Composio is licensed under the Elastic License - see the LICENSE file for details.

💪 Thanks To All Contributors

List of Contributors

Project details


Release history Release notifications | RSS feed

This version

0.4.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

composio_core-0.4.1.tar.gz (196.9 kB view details)

Uploaded Source

Built Distribution

composio_core-0.4.1-py3-none-any.whl (280.2 kB view details)

Uploaded Python 3

File details

Details for the file composio_core-0.4.1.tar.gz.

File metadata

  • Download URL: composio_core-0.4.1.tar.gz
  • Upload date:
  • Size: 196.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for composio_core-0.4.1.tar.gz
Algorithm Hash digest
SHA256 830afd27c352f32b113362f13370bf9b14696ad1dcd73f4974034cc02c1eaa24
MD5 84a619f6e4d8acbf32cbae3ce75fa9f0
BLAKE2b-256 16986a1f34b8c423cc5886059ef5325615e6e86b6565a93dfb14ddf3cc599227

See more details on using hashes here.

File details

Details for the file composio_core-0.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for composio_core-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5638cdf7369656e881d658fb59cc97d28e425bf9b94d7685c3fc9ab8acfd438b
MD5 8e47e8dbeb85d901b710d5e0ea273a12
BLAKE2b-256 026962fef33284b3d9b458b6121ee1632bab6337d139ab39d931b776b95e30a2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page