repowisecomposiohq/composio

Architecture of composiohq/composio

composiohq/composio is 2,986 source files holding 13,383 symbols across 10 modules, written mainly in TypeScript, Python, JavaScript. The largest module is ts, with 1,063 files, and 52 files are entry points into the dependency graph.

How composio fits together

Input enters through the TypeScript SDK in ts/packages/core, the Python SDK in python/composio, or the composio CLI in ts/packages/cli. The Python entry point python/composio/__init__.py exposes the Composio class that the provider packages build on. Provider adapters in python/providers, such as python/providers/anthropic and python/providers/autogen, convert Composio tools into each agent framework's native tool format, and ts/packages/providers holds the TypeScript equivalents. The root file tsdown.config.base.ts sets shared build defaults that package configs extend. The harness/run.mjs runner builds a command line from each entry's declared language, runs it detached from its parent, and streams its output to detect readiness. The result is tools that the agent can discover, authenticate, and execute at runtime.

Largest modules

  • ts: 1,063 files and 154,210 lines of code
  • docs: 363 files and 45,942 lines of code
  • python: 237 files and 54,496 lines of code
  • .github: 8 files and 449 lines of code
  • harness: 7 files and 961 lines of code
  • test: 7 files and 3,768 lines of code
  • install: 3 files and 192 lines of code
  • root: 3 files and 824 lines of code

Languages

By file count: TypeScript 1,408 files, Python 239 files, JavaScript 24 files, Shell 21 files, Makefile 1 file.

Documentation

Repowise documents composio in 1,844 pages generated from the source, 68 of them written explanations of the repository and its modules. Module guides include:

  • ts/packages/cli/src/commands/agent: Agent Command Set
  • ts/packages/cli/src/models: CLI Data Models
  • ts/packages/cli/src/effects: CLI Effects Implementation

More on composio: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos