composiohq--composio/python/providers/AGENTS.md

AGENTS.md

Python provider guidance.

Scope

Each child directory is a Python provider package that adapts Composio to a framework or agent runtime.

Skill Routing

Use python-providers for provider implementation and python-testing for nox/pytest verification. Use cross-sdk-parity when the provider mirrors a TypeScript package.

Commands

Run from python/:

make create-provider name=<provider-name>
make create-provider name=<provider-name> agentic=true
make chk
make tst
make type_inference

Rules

• Keep provider dependencies in the provider package metadata unless shared tooling needs them.
• Preserve Python naming conventions and public import paths.
• Add provider tests and type-inference coverage when public return types change.
• New providers or renamed provider packages usually need explicit entries in python/noxfile.py's type_inference install list and checked-file list.
• Verify package metadata before release-facing changes.