prime-tunnel

What it is and what it does

Prime Tunnel SDK is a Python client library for creating secure reverse tunnels that expose local services to the internet via Prime infrastructure. It abstracts away the complexity of tunnel management, offering both a programmatic async API and a command-line interface. The package wraps httpx for HTTP communication, pydantic for configuration validation, and tenacity for resilient retry logic.

Typical usage involves instantiating a Tunnel object with a local port number, entering an async context manager, and receiving a public URL that routes traffic back to the local service. The CLI provides complementary commands for starting tunnels, listing active ones, and checking status. It targets developers who need to expose development servers, webhooks, or internal services for testing, collaboration, or integration without managing their own infrastructure.

Use it for:

• Expose a local development server to external webhook consumers during testing.
• Share a running application with remote team members without deploying to production.
• Provide temporary public access to a local database or API for third-party integrations.
• Test ngrok-like functionality within a Python application using the async SDK.
• Run CLI commands to manage multiple concurrent tunnels for different local services.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Exposes local services via secure tunnels on Prime infrastructure, making them accessible over the internet through a managed reverse-proxy mechanism.

Yes, if you need to expose local services publicly and trust Prime's infrastructure. The package is actively maintained, has low install friction, carries no security vulnerabilities, and uses a permissive MIT license. The three runtime dependencies are mature. Start with the async context manager example; verify that Prime's tunnel endpoints and latency meet your use case before committing to production.

Install

prime-tunnel on PyPI

pip install prime-tunnel

uv add prime-tunnel

poetry add prime-tunnel

Installing prime-tunnel

Before you install

Low install friction with a pure Python wheel. Maintenance is active with recent commits and a modest but growing user base (286 stars, 453882 monthly downloads). Three lightweight runtime dependencies (httpx, pydantic, tenacity) are well-established libraries.

License in practice

MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions—only requiring attribution and inclusion of the license text.

Quickstart

pip install prime-tunnel

from prime_tunnel import Tunnel

async with Tunnel(local_port=8765) as tunnel:
    print(f"Tunnel URL: {tunnel.url}")

Requires Python 3.10 or later; async/await syntax required for context manager usage.

Verify before relying

• Whether tunnels persist across client disconnections or require continuous connection.
• Authentication and authorization model for accessing exposed services.
• Rate limiting, bandwidth, or concurrent tunnel limits on Prime infrastructure.
• Geographic region or latency characteristics of tunnel endpoints.

Package facts

Evidence: prime_tunnel-0.1.10-py3-none-any.whl

Keywords: frp, networking, reverse-proxy, sdk, tunnel

Tags

More Python Modules packages