🔌📞 Pyvider RPC Plugin

High-performance, type-safe RPC plugin framework for Python.

Modern gRPC-based plugin architecture with async support, mTLS security, and comprehensive transport options.

Build lightning-fast, secure RPC plugins! pyvider.rpcplugin provides a complete framework for creating high-performance RPC-based plugins with built-in security, async support, and production-focused patterns. Perfect for microservices, plugin architectures, and inter-process communication.

✨ Key Features

• 🔌 gRPC Framework - High-performance plugin framework with strong typing
• ⚡ Async-First - Native async APIs with secure mTLS support
• 🧱 Foundation Integration - Seamless integration with provide.foundation utilities

Quick Start

Note: pyvider-rpcplugin is in pre-release (v0.x.x). APIs and features may change before 1.0 release.

1. Install: uv add pyvider-rpcplugin
2. Follow the Quick Start guide.
3. Build your first plugin via docs/getting-started/first-plugin.md.

Documentation

• Documentation index
• Getting started
• Guide

Development

Quick Start

# Set up environment
uv sync

# Run common tasks
we run test       # Run tests
we run lint       # Check code
we run format     # Format code
we tasks          # See all available commands

See CLAUDE.md for detailed development instructions and architecture information.

🤝 Contributing

We welcome contributions! Please see Contributing to Pyvider RPCPlugin for details.

📜 License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

📖 Full Documentation

For a comprehensive guide to installing, using, and understanding pyvider.rpcplugin, including tutorials, advanced topics, and API references, please see the:

➡️ Documentation Home

Complete documentation with tutorials, examples, API reference, and deployment guides.

Overview

pyvider.rpcplugin is a Python framework designed to simplify the creation of robust, secure, and high-performance RPC-based plugin systems. It leverages gRPC for efficient communication and integrates with Foundation for:

• Async Operations: Native asyncio integration.
• Secure Communication: mTLS with Foundation's certificate management utilities.
• Flexible Transports: Unix Domain Sockets (for local IPC) and TCP sockets (for network IPC).
• Standardized Handshake: Secure plugin authentication using magic cookies and protocol/transport negotiation.
• Developer-Friendly Features: Type safety, factory functions for common patterns, and Foundation's structured logging.

Quick Installation

# With uv (recommended)
uv add pyvider-rpcplugin

Dive into the Documentation to get started!

Copyright (c) provide.io LLC.