@guyycodes/plugin-sdk/README.md

AI-powered plugin scaffolding tool - Create full-stack applications with 7+ AI models, 50+ business integrations, and production-ready infrastructure

# Plugin SDK

<p align="center">
  <a href="https://www.npmjs.com/package/@guyycodes/plugin-sdk"><img src="https://img.shields.io/npm/v/@guyycodes/plugin-sdk.svg" alt="NPM Version"></a>
  <a href="https://www.npmjs.com/package/@guyycodes/plugin-sdk"><img src="https://img.shields.io/npm/dt/@guyycodes/plugin-sdk.svg" alt="NPM Downloads"></a>
  <a href="https://github.com/guyycodes/plugin-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT--Attribution-blue.svg" alt="License"></a>
  <a href="https://github.com/guyycodes/plugin-sdk"><img src="https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg" alt="Node Version"></a>
</p>

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

```bash
npm install -g plugin-sdk
```

Or use directly with npx:

```bash
npx plugin-sdk init
```

## 🚀 Quick Start

### Create a New Plugin

```bash
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

```bash
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:

```bash
cd my-plugin

# Install dependencies
npm install

# Start development servers
npm run dev
```

This starts:
- Frontend: http://localhost:5173
- Backend: http://localhost:3000

## 📖 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](CONTRIBUTING.md) for details.

## 📄 License

MIT License with Attribution Requirement - see [LICENSE](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)
```

## 🔗 Links

- [GitHub Repository](https://github.com/guyycodes/plugin-sdk.git)
- [NPM Package](https://www.npmjs.com/package/plugin-sdk)
- [Documentation](https://github.com/yourusername/plugin-sdk/readme.md)

## 💬 Support

- [Report Issues](https://github.com/guyycodes/plugin-sdk/issues)
- [Discussions](https://github.com/guyycodes/plugin-sdk/discussions)

---

Built with ❤️ by the Plugin SDK team