Supyagent

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:

  1. 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.

  2. Supyagent Framework — An LLM agent framework that wraps supypowers with a conversation loop, multi-agent delegation, context management, and session persistence.

  3. Supyagent Cloud — A SaaS platform that connects your agents to third-party services (Google, Slack, GitHub, Discord, and more) via a unified API.

  4. 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 with create-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.    │
└─────────────────┘    └───────────────────┘