Welcome to Supyagent
Build AI agents with tool use, multi-agent orchestration, and cloud integrations.
Supyagent
Supyagent is a framework for building AI agents that can use tools, delegate tasks to other agents, and connect to cloud services — all through a simple YAML configuration and Python scripts.
What is Supyagent?
Supyagent is four things:
-
Supypowers — A CLI tool that turns Python scripts into callable, schema-documented functions. Each script declares its own dependencies and runs in an isolated environment.
-
Supyagent Framework — An LLM agent framework that wraps supypowers with a conversation loop, multi-agent delegation, context management, and session persistence.
-
Supyagent Cloud — A SaaS platform that connects your agents to third-party services (Google, Slack, GitHub, Discord, and more) via a unified API.
-
Supyagent SDK — A Node.js/TypeScript SDK (
@supyagent/sdk) that integrates Supyagent Cloud with the Vercel AI SDK. Includes tools, chat persistence, context management, and React UI components. Scaffold a full app withcreate-supyagent-app.
Architecture
┌─────────────────────────────────────────────────┐
│ Your Agent │
│ ┌───────────┐ ┌──────────┐ ┌──────────────┐ │
│ │ LLM │ │ Tools │ │ Delegation │ │
│ │ (LiteLLM) │ │ (supyp.) │ │ (sub-agents)│ │
│ └───────────┘ └──────────┘ └──────────────┘ │
│ │ │ │ │
│ └──────────────┼──────────────┘ │
│ │ │
│ ┌─────────┴─────────┐ │
│ │ Engine Loop │ │
│ │ User → LLM → │ │
│ │ Tools → LLM → │ │
│ │ Response │ │
│ └───────────────────┘ │
└─────────────────────────────────────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌───────────────────┐
│ Local Tools │ │ Cloud Services │
│ (supypowers) │ │ (supyagent.com) │
│ shell, files, │ │ Gmail, Slack, │
│ search, git, │ │ GitHub, Drive, │
│ browser, web │ │ Discord, etc. │
└─────────────────┘ └───────────────────┘Quick Links
Getting Started
Install supyagent and create your first agent in 5 minutes.
Building Agents
Configure agents with YAML, set up models, tools, and prompts.
Multi-Agent Workflows
Delegate tasks between agents for complex workflows.
Building Tools
Create custom tools with supypowers.
Cloud Integrations
Connect agents to Gmail, Slack, GitHub, and 12+ services.
SDK (Node.js)
TypeScript SDK for Vercel AI SDK — tools, persistence, context, and React UI.
Embedding in IDEs
Use supyagent skills in Claude Code, Codex, and Cursor.