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.
- 🔌 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
Note: pyvider-rpcplugin is in pre-release (v0.x.x). APIs and features may change before 1.0 release.
- Install:
uv add pyvider-rpcplugin - Follow the Quick Start guide.
- Build your first plugin via docs/getting-started/first-plugin.md.
# 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 commandsSee CLAUDE.md for detailed development instructions and architecture information.
We welcome contributions! Please see Contributing to Pyvider RPCPlugin for details.
This project is licensed under the Apache 2.0 License. See the LICENSE file for details.
For a comprehensive guide to installing, using, and understanding pyvider.rpcplugin, including tutorials, advanced topics, and API references, please see the:
Complete documentation with tutorials, examples, API reference, and deployment guides.
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
asynciointegration. - 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.
# With uv (recommended)
uv add pyvider-rpcpluginDive into the Documentation to get started!
Copyright (c) provide.io LLC.