# 建议写入项目根目录的 .env（示例）
COMPOSIO_API_KEY=your_composio_api_key
OPENAI_API_KEY=your_openai_api_key

# 1. 准备 Python 3.11+ 环境（示例用 uv，也可用 venv）
uv venv .venv && source .venv/bin/activate

# 2. 安装 Composio + OpenAI Agents 适配器（官方 Quickstart 组合）
uv add python-dotenv composio composio-openai-agents openai-agents

# 注意：不要安装 composio-core，它是 v1 遗留包，与 sessions 不兼容

# 3. 新建 agent.py，写入下方代码
python agent.py

from dotenv import load_dotenv
from composio import Composio
from agents import Agent, Runner, SQLiteSession
from composio_openai_agents import OpenAIAgentsProvider

load_dotenv()

composio = Composio(provider=OpenAIAgentsProvider())

# 为你的用户创建会话；生产环境请换成你自己系统里的稳定 user_id
session = composio.sessions.create(user_id="user_123")
tools = session.tools()

agent = Agent(
    name="Personal Assistant",
    instructions=(
        "Use Composio tools to complete the request. "
        "If a connection is required, share its Connect Link and wait. "
        "Ask for confirmation before creating, updating, or deleting data."
    ),
    tools=tools,
)

memory = SQLiteSession("conversation")

while True:
    user_input = input("You: ").strip()
    if user_input.lower() == "exit":
        break
    result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)
    print(f"{result.final_output}\n")

# Node 22+（nvm 示例）
nvm install 22 && nvm use 22

# 官方 Quickstart 组合
npm install @composio/core @composio/openai-agents @openai/agents

import { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";

const composio = new Composio({ provider: new OpenAIAgentsProvider() });

// 每个会话绑定一个你的用户
const session = await composio.create("user_123");
const tools = await session.tools();

const agent = new Agent({
  name: "Personal Assistant",
  instructions: "You are a helpful assistant. Use Composio tools to take action.",
  tools,
});

const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);

# 一键安装脚本：下载 release 到 ~/.composio，symlink 到 ~/.local/bin/composio
curl -fsSL https://composio.dev/install | sh

# 新开终端后登录（会打开浏览器完成 OAuth）
composio login

# 无人值守/CI 场景：不需要浏览器的 agent 登录
composio login --agent

# 验证
composio --version

# 固定版本并跳过 agent 插件
curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_VERSION=0.3.1 COMPOSIO_INSTALL_PLUGINS=0 sh

# CI/Docker 场景：不改 shell 配置、不装插件
curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELL=none COMPOSIO_INSTALL_PLUGINS=0 sh

# 管理员 PowerShell，安装 WSL2 + Ubuntu
wsl --install

# 进入 WSL 后
curl -fsSL https://composio.dev/install | sh && composio login

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt   # requirements.txt 中包含 composio、composio-openai-agents 等
COPY . .
CMD ["python", "agent.py"]

docker build -t my-agent . && docker run --rm -it \
  -e COMPOSIO_API_KEY=$COMPOSIO_API_KEY \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  my-agent

git clone https://github.com/ComposioHQ/composio.git
cd composio
mise install      # 安装 pin 好的 Node/Python/pnpm 工具链
pnpm install
pnpm build
pnpm test
# Python 子项目在 python/ 目录，见 python/README.md

# ===== 必填 =====
COMPOSIO_API_KEY=cmp_xxxxxxxxxxxx   # Composio 平台 Key
OPENAI_API_KEY=sk-xxxxxxxxxxxx      # 模型侧 Key（按所用框架选择厂商）

# ===== 可选：后端与环境 =====
# COMPOSIO_BASE_URL=                # 通常留空，使用官方托管后端
# COMPOSIO_ENVIRONMENT=             # 通常留空

# ===== 可选：CLI 行为 =====
# COMPOSIO_DISABLE_TELEMETRY=1      # 关闭匿名遥测
# COMPOSIO_INSTALL_DIR=/opt/composio
# COMPOSIO_BIN_DIR=/usr/local/bin

python agent.py          # Python
node dist/index.js       # TypeScript（先 tsc build）
composio dev listen --toolkits gmail --table   # 本地监听 Trigger

# /etc/systemd/system/composio-agent.service
[Unit]
Description=Composio Agent App
After=network-online.target

[Service]
Type=simple
User=deploy
WorkingDirectory=/opt/my-agent
EnvironmentFile=/opt/my-agent/.env
ExecStart=/opt/my-agent/.venv/bin/python agent.py
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now composio-agent
journalctl -u composio-agent -f      # 查看日志

# /etc/supervisor/conf.d/composio-agent.conf
[program:composio-agent]
command=/opt/my-agent/.venv/bin/python agent.py
directory=/opt/my-agent
autostart=true
autorestart=true
environment=COMPOSIO_API_KEY="cmp_xxx",OPENAI_API_KEY="sk-xxx"
stdout_logfile=/var/log/composio-agent.log

sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start composio-agent

# docker-compose.yml
services:
  agent:
    build: .
    restart: unless-stopped
    env_file: .env

server {
  listen 443 ssl;
  server_name agent.example.com;
  location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

composio login                      # 首次先登录
composio search "summarize my unread gmail"   # 自然语言找工具

composio execute <tool-slug> --get-schema       # 先看该工具的 input schema
composio execute <tool-slug> -d '{"query":"is:unread"}'   # 带参数执行

composio link gmail       # 输出 Connect Link，浏览器打开完成 Google OAuth
composio connections list # 确认连接已 ACTIVE

import { Composio } from "@composio/core";

const composio = new Composio();
const session = await composio.create("user_123");
console.log(session.sessionId);   // 存到你的数据库，下轮复用
const tools = await session.tools();

const session = composio.use(savedSessionId);

uv add composio composio-crewai crewai

from composio import Composio
from composio_crewai import CrewAIProvider
from crewai import Agent as CrewAgent, Task, Crew

composio = Composio(provider=CrewAIProvider())
session = composio.sessions.create(user_id="user_123")
tools = session.tools()

researcher = CrewAgent(
    role="Researcher",
    goal="Use Composio tools to gather repo info",
    backstory="A diligent research assistant.",
    tools=tools,
    allow_delegation=False,
)
crew = Crew(agents=[researcher], tasks=[Task(
    description="List open issues of ComposioHQ/composio",
    expected_output="A markdown list of issues",
    agent=researcher,
)])
print(crew.kickoff())

session = composio.sessions.create(user_id="user_123", mcp=True)
print(session.mcp.url)   # 把这个 URL 填进 MCP 客户端配置

composio run '
const tools = await search("github list issues");
const r = await execute(tools[0].slug, { repo: "ComposioHQ/composio" });
console.log(r.data);
'

# 表格视图监听 Gmail 事件
composio dev listen --toolkits gmail --table

# 收满 5 条 raw JSON 后停止
composio dev listen --trigger-slug GMAIL_NEW_GMAIL_MESSAGE --json --max-events 5

# 转发到自己的 webhook
composio dev listen --toolkits github --forward https://example.com/webhook

composio --version
pip show composio
npm ls @composio/core

# CLI
composio upgrade              # 升到最新稳定版
composio upgrade 0.3.1        # 升到指定版本
composio upgrade --beta       # 最新预发布

# Python SDK
uv add composio@latest        # 或 pip install -U composio

# TypeScript SDK
npm install @composio/core@latest

pip install composio==0.30.0
npm install @composio/core@<指定版本>
curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_VERSION=0.3.1 sh

# CLI（官方文档：默认卸载保留凭据/配置/缓存）
rm -f ~/.local/bin/composio
rm -rf ~/.composio            # 彻底删除 CLI 全部状态（含凭据、analytics.json）
# 手动清理安装脚本写入的 "# Composio CLI" PATH block（~/.zshrc / ~/.bashrc）

# Python
pip uninstall composio composio-openai-agents

# TypeScript
npm uninstall @composio/core @composio/openai-agents

# 环境变量：从 .env / 系统环境中移除 COMPOSIO_API_KEY 等
# Dashboard：不需要时可在 dashboard.composio.dev 删除项目与连接

# ===== 安装 =====
curl -fsSL https://composio.dev/install | sh          # 安装 CLI
pip install composio composio-openai-agents           # Python SDK
npm install @composio/core @composio/openai-agents    # TypeScript SDK

# ===== 登录与配置 =====
composio login                                        # 浏览器登录
composio login --agent                                # 无人值守登录
composio orgs switch                                  # 切换组织
composio --version

# ===== 工具搜索与执行 =====
composio search "summarize my unread gmail"
composio execute <slug> --get-schema
composio execute <slug> -d '{"key":"value"}'
composio execute <slug> --account <connected-account-id>
composio proxy <provider-url> --toolkit <toolkit>

# ===== 连接管理 =====
composio link gmail
composio connections list
composio dev auth-configs list --toolkits github,gmail
composio dev connected-accounts list --status ACTIVE

# ===== Trigger =====
composio dev listen --toolkits gmail --table
composio dev triggers list gmail
composio dev triggers enable <trigger-id>

# ===== 脚本与调试 =====
composio run --file ./workflow.ts -- --repo ComposioHQ/composio
composio dev logs tools --toolkit gmail --limit 20
composio generate ts --toolkits github,gmail          # 生成工具类型

# ===== 升级/卸载 =====
composio upgrade
pip install -U composio
npm install @composio/core@latest
rm -rf ~/.composio                                    # 彻底清除 CLI 状态