easyremote 0.1.2.2.5

Easy remote function execution framework

EasyRemote

A lightweight framework for hassle-free remote computing resource sharing.

English | 中文

Why EasyRemote?

Are you tired of:

• Paying expensive cloud GPU fees for AI development?
• Struggling with complex deployment for demos?
• Looking for ways to share computing resources within your team?

EasyRemote lets you expose local computing resources (AI models, data processing functions) as remote services with just a few lines of code. All you need is a cheap VPS!

# It's as simple as this (register):
from easyremote import ComputeNode

# Initialize ComputeNode with VPS address and unique node ID
node = ComputeNode(
    vps_address="your-vps-ip:8080",
    node_id="basic-compute"
)

@node.register
def run_model(input_data):
    return your_ai_model(input_data)  # Executes on your local GPU

if __name__ == "__main__":
    node.serve()

Features

• 🚀 Super Simple: Turn any function into a remote service with a single decorator
• 💰 Cost-Effective: Use your local GPU through an inexpensive VPS
• 🔒 Private & Secure: All computation stays on your local machine
• 🌐 Flexible Deployment: Perfect for demos, prototypes, and team collaboration

Quick Start

1. Installation

pip install easyremote

2. Set Up VPS (Gateway&&Call)

from easyremote import Server

app = FastAPI()
server = Server(port=8080)

@remote(node_id="basic-compute")
def add(a: int, b: int) -> int:
    pass

3. Configure Local Node

from easyremote import ComputeNode

# Connect to your VPS
node = ComputeNode("your-vps-ip:8080")

# Define your remote functions
@node.register
def process_data(data):
    return heavy_computation(data)  # Runs locally

# Start serving
node.serve()

Advanced Usage

Async Support

@node.register(async_func=True)
async def async_process(data):
    result = await complex_async_operation(data)
    return result

Streaming Results

@node.register(stream=True)
def stream_results(data):
    for chunk in process_large_dataset(data):
        yield chunk

Real-world Examples

Check out our examples directory for:

• AI Model Serving
• Data Pipeline Processing
• Team Resource Sharing
• And more!

Architecture

Client -> VPS (Gateway) -> Local Compute Node
                       -> Local Compute Node
                       -> Local Compute Node

Performance

• Efficient binary protocol
• Support for large data transfer
• Automatic connection management

Roadmap

• Rewrite Distributed Network Using Go's Kitex Framework
• Multi-node clustering support
• Enhanced security features
• Web-based management UI
• More language SDKs
• Docker support

Contributing

We welcome contributions! Please see our Contributing Guide

License

MIT License

Contact & Support

• Author: Silan Hu
• Email: [e-mail]
• GitHub: Qingbolan

Acknowledgments

Special thanks to all contributors who have helped make EasyRemote better!

---

*If you find EasyRemote useful, please consider giving it a star ⭐*