Skip to content

AgentUp Plugin System

The AgentUp plugin system is for extending AI agent capabilities and provides a clean, type-safe, and extensible way to create, distribute, and manage agent functionality.

What Are Plugins?

Plugins are independent Python packages that extend your agent's capabilities. They can be developed, tested, and distributed separately from the main agent codebase. This carries several benefits: - Modular - each plugin encapsulates specific functionality - Reusable - plugins can be shared across different agents - Versioned - plugins can be versioned independently - Discoverable - plugins are automatically discovered by the AgentUp framework

Quick Start

1. Create Your First Plugin

Plugins can be created anywhere - you don't need to be inside an agent project:

# Create a new plugin with interactive prompts (run from any directory)
agentup plugin init

# Or specify details directly
agentup plugin init weather-plugin --template ai

# This creates a new directory with your plugin
cd weather-plugin/

2. Develop and Test

# Install your plugin in development mode
pip install -e .

3. Use in Your Agent

Plugins are discovered automatically through two methods:

a) Development Mode (Recommended for plugin development) 

# Navigate to your plugin directory
cd /path/to/weather-plugin

# Install in development mode
pip install -e .

b) Production Mode (For published packages) 

# Install from PyPI or other sources
pip install agentup-weather-plugin

Plugin Types

Basic Plugins

Perfect for simple direct routed functions, where an LLM is not required.

AI Plugins

Provide LLM-callable functions for agent interactions.

Documentation Sections

  1. Getting Started - Create your first plugin in 5 minutes
  2. Plugin Development - Comprehensive development guide
  3. AI Function Integration - Build LLM-callable functions
  4. Scopes and Security - Plugin security and access control
  5. System Prompts - Customize AI behavior with capability-specific system prompts
  6. Testing Plugins - Test your plugins thoroughly
  7. CLI Reference - Complete CLI command documentation

Architecture Overview

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Your Plugin   │    │  AgentUp Core    │    │   LLM Service   │
│                 │    │                  │    │                 │
│ ┌─────────────┐ │    │ ┌──────────────┐ │    │ ┌─────────────┐ │
│ │ Skill Logic │◄┼────┼►│ Plugin Mgr   │◄┼────┼►│ Function    │ │
│ └─────────────┘ │    │ └──────────────┘ │    │ │ Calling     │ │
│ ┌─────────────┐ │    │ ┌──────────────┐ │    │ └─────────────┘ │
│ │AI Functions │◄┼────┼►│ Function Reg │ │    │                 │
│ └─────────────┘ │    │ └──────────────┘ │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘

The plugin system provides clean interfaces between your code and the agent infrastructure, making plugin development straightforward and maintainable, and best of all, sharable with the community.