guyycodes/plugin-sdk

A scaffolding tool for creating full-stack AI-powered apps. Build production-ready Client/Server with your choice of backend (Python/TypeScript/Node.js) and modern React frontent, 1 line of code.

0

stars

68

commits

JavaScript

primary language

Aug 16, 2025

updated

www.npmjs.com/package/@guyycodes/plugin-sdk

README

Plugin SDK

NPM Version NPM Downloads License Node Version

A powerful scaffolding tool for creating full-stack AI-powered plugin applications with business integrations. Build production-ready plugins with your choice of backend (Python/Node.js) and modern React frontend in minutes.

✨ Features

  • 🤖 AI-Powered: Pre-configured with 7+ AI models (GPT-4, Qwen, DeepHermes, Flux, Phi-4)
  • 🔌 50+ Business Integrations: QuickBooks, Stripe, Shopify, Slack, HubSpot, and more
  • 🎨 Modern Frontend: React + TypeScript/JavaScript with Vite
  • 🚀 Production Ready: Docker support, CI/CD pipelines, WebSocket real-time features
  • 🛠️ Flexible Backend: Choose between Python (FastAPI) or Node.js (Express)
  • 📦 Multi-Modal Support: Handle text, images, audio, and code
  • 🔄 LangGraph Architecture: Advanced agent orchestration and tool execution

📦 Installation

npm install -g plugin-sdk

Or use directly with npx:

npx plugin-sdk init

🚀 Quick Start

Create a New Plugin

plugin-sdk init

You'll be prompted to configure:

  • Backend type (Python/Node.js)
  • Frontend type (TypeScript/JavaScript)
  • Integration preset (QuickBooks, Stripe, Calendly, or custom)

Example with Options

plugin-sdk init my-plugin --backend python --frontend typescript 

🏗️ What Gets Created

my-plugin/
├── src/
│   ├── client/          # React frontend with Vite
│   │   ├── src/
│   │   │   ├── pages/   # Pre-built UI pages
│   │   │   ├── components/
│   │   │   └── api/     # API client
│   │   └── package.json
│   │
│   └── server/          # Backend server
│       ├── agent/       # LangGraph agent system
│       ├── models/      # AI model configurations
│       ├── integrations/# Business tool integrations
│       ├── tools/       # Agent tools
│       └── main.py/js   # Server entry point
│
├── .github/workflows/   # CI/CD pipelines
├── Dockerfile          # Production deployment
├── app.config.json     # Plugin configuration
└── README.md          # Project documentation

🎯 Key Features

AI Models

  • GPT-4o-mini: General purpose, web search, tool use
  • Qwen2.5-Math: Mathematical reasoning and calculations
  • DeepHermes-3: Advanced reasoning and instruction following
  • Phi-4: Multimodal (text, image, audio)
  • FLUX: Text-to-image generation
  • FluxKontext: Image editing and modification
  • Qwen2.5-Coder: Code generation and analysis

Business Integrations

  • Payments: Stripe, Square, QuickBooks
  • E-commerce: Shopify, WooCommerce
  • Marketing: Mailchimp, HubSpot
  • Communication: Slack, email
  • Scheduling: Calendly
  • Analytics: Looker Studio
  • And many more...

Frontend Features

  • Modern React with TypeScript/JavaScript
  • Pre-built pages: Chat, Dashboard, Settings, Auth
  • Real-time WebSocket updates
  • Responsive design
  • API client with error handling

Backend Features

  • FastAPI (Python) or Express (Node.js)
  • LangGraph agent orchestration
  • Streaming responses
  • Session management
  • Multi-agent support
  • Extensible tool system

🛠️ Development

After creating your plugin:

cd my-plugin

# Install dependencies
npm install

# Start development servers
npm run dev

This starts:

📖 Documentation

For detailed documentation on:

  • Adding new AI models
  • Creating custom integrations
  • Extending the agent system
  • Deployment guides

Visit the /docs folder in your generated project.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📄 License

MIT License with Attribution Requirement - see LICENSE file for details.

Attribution Required: If you use this SDK in your project, you must include attribution:

Built with Plugin SDK by Morgan Beals (https://github.com/guyycodes/plugin-sdk)

💬 Support


Built with ❤️ by the Plugin SDK team

Contributors

guyycodes

68 commits

guyycodes/plugin-sdk

A scaffolding tool for creating full-stack AI-powered apps. Build production-ready Client/Server with your choice of backend (Python/TypeScript/Node.js) and modern React frontent, 1 line of code.

0

stars

68

commits

JavaScript

primary language

Aug 16, 2025

updated

www.npmjs.com/package/@guyycodes/plugin-sdk

README

Plugin SDK

NPM Version NPM Downloads License Node Version

A powerful scaffolding tool for creating full-stack AI-powered plugin applications with business integrations. Build production-ready plugins with your choice of backend (Python/Node.js) and modern React frontend in minutes.

✨ Features

  • 🤖 AI-Powered: Pre-configured with 7+ AI models (GPT-4, Qwen, DeepHermes, Flux, Phi-4)
  • 🔌 50+ Business Integrations: QuickBooks, Stripe, Shopify, Slack, HubSpot, and more
  • 🎨 Modern Frontend: React + TypeScript/JavaScript with Vite
  • 🚀 Production Ready: Docker support, CI/CD pipelines, WebSocket real-time features
  • 🛠️ Flexible Backend: Choose between Python (FastAPI) or Node.js (Express)
  • 📦 Multi-Modal Support: Handle text, images, audio, and code
  • 🔄 LangGraph Architecture: Advanced agent orchestration and tool execution

📦 Installation

npm install -g plugin-sdk

Or use directly with npx:

npx plugin-sdk init

🚀 Quick Start

Create a New Plugin

plugin-sdk init

You'll be prompted to configure:

  • Backend type (Python/Node.js)
  • Frontend type (TypeScript/JavaScript)
  • Integration preset (QuickBooks, Stripe, Calendly, or custom)

Example with Options

plugin-sdk init my-plugin --backend python --frontend typescript 

🏗️ What Gets Created

my-plugin/
├── src/
│   ├── client/          # React frontend with Vite
│   │   ├── src/
│   │   │   ├── pages/   # Pre-built UI pages
│   │   │   ├── components/
│   │   │   └── api/     # API client
│   │   └── package.json
│   │
│   └── server/          # Backend server
│       ├── agent/       # LangGraph agent system
│       ├── models/      # AI model configurations
│       ├── integrations/# Business tool integrations
│       ├── tools/       # Agent tools
│       └── main.py/js   # Server entry point
│
├── .github/workflows/   # CI/CD pipelines
├── Dockerfile          # Production deployment
├── app.config.json     # Plugin configuration
└── README.md          # Project documentation

🎯 Key Features

AI Models

  • GPT-4o-mini: General purpose, web search, tool use
  • Qwen2.5-Math: Mathematical reasoning and calculations
  • DeepHermes-3: Advanced reasoning and instruction following
  • Phi-4: Multimodal (text, image, audio)
  • FLUX: Text-to-image generation
  • FluxKontext: Image editing and modification
  • Qwen2.5-Coder: Code generation and analysis

Business Integrations

  • Payments: Stripe, Square, QuickBooks
  • E-commerce: Shopify, WooCommerce
  • Marketing: Mailchimp, HubSpot
  • Communication: Slack, email
  • Scheduling: Calendly
  • Analytics: Looker Studio
  • And many more...

Frontend Features

  • Modern React with TypeScript/JavaScript
  • Pre-built pages: Chat, Dashboard, Settings, Auth
  • Real-time WebSocket updates
  • Responsive design
  • API client with error handling

Backend Features

  • FastAPI (Python) or Express (Node.js)
  • LangGraph agent orchestration
  • Streaming responses
  • Session management
  • Multi-agent support
  • Extensible tool system

🛠️ Development

After creating your plugin:

cd my-plugin

# Install dependencies
npm install

# Start development servers
npm run dev

This starts:

📖 Documentation

For detailed documentation on:

  • Adding new AI models
  • Creating custom integrations
  • Extending the agent system
  • Deployment guides

Visit the /docs folder in your generated project.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📄 License

MIT License with Attribution Requirement - see LICENSE file for details.

Attribution Required: If you use this SDK in your project, you must include attribution:

Built with Plugin SDK by Morgan Beals (https://github.com/guyycodes/plugin-sdk)

💬 Support


Built with ❤️ by the Plugin SDK team

Contributors

guyycodes

68 commits

Languages

JavaScript

100.0%