Skip to main content

subspace

Expose a local HTTP service (e.g. LLM inference on a GPU machine) through a public relay server, without touching firewall or NAT rules.

The GPU machine dials out to the server; requesters reach it by passing its id as a bearer token.

requester --HTTP--> subspace server (public) <--websocket-- subspace client --> localhost:<port>

Install

uv tool install subspace-tunnel

Server

# server.yaml
listen: ":8080"
client_tokens:
  - "some-long-random-token"
subspace server --config server.yaml

TLS is out of scope, put the server behind Caddy/nginx/etc.

Client (GPU machine)

subspace client --server https://relay.example.com --token some-long-random-token --id some-long-random-id --port 8000

--upstream-authorization "Bearer sk-..." sets the Authorization header sent to the local port. Without it, the header is stripped.

Only one client can hold an id at a time. The id is freed when the client disconnects, or ~20s after it dies.

Requester

curl https://relay.example.com/v1/models -H "Authorization: Bearer some-long-random-id"

The id is effectively an api key: anyone who knows it can use the exposed service.

Metadata

Release files for subspace-tunnel 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for subspace-tunnel 0.1.0
File Actions
subspace_tunnel-0.1.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for subspace_tunnel-0.1.0-py3-none-win_arm64.whl
subspace_tunnel-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for subspace_tunnel-0.1.0-py3-none-win_amd64.whl
subspace_tunnel-0.1.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for subspace_tunnel-0.1.0-py3-none-musllinux_1_2_x86_64.whl
subspace_tunnel-0.1.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for subspace_tunnel-0.1.0-py3-none-musllinux_1_2_aarch64.whl
subspace_tunnel-0.1.0-py3-none-manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for subspace_tunnel-0.1.0-py3-none-manylinux_2_17_x86_64.whl
subspace_tunnel-0.1.0-py3-none-manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for subspace_tunnel-0.1.0-py3-none-manylinux_2_17_aarch64.whl
subspace_tunnel-0.1.0-py3-none-macosx_12_0_x86_64.whl Python 3 none macOS 12.0+ x86-64 Details for subspace_tunnel-0.1.0-py3-none-macosx_12_0_x86_64.whl
subspace_tunnel-0.1.0-py3-none-macosx_12_0_arm64.whl Python 3 none macOS 12.0+ ARM64 Details for subspace_tunnel-0.1.0-py3-none-macosx_12_0_arm64.whl

Total release size: 56.7 MB

Release files / subspace_tunnel-0.1.0-py3-none-win_arm64.whl

Download URL subspace_tunnel-0.1.0-py3-none-win_arm64.whl
Size 6.9 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
0692fd2b3178f4b86429fa29d59b12f6547d67d7d3e3b8f69b66dcc5b6d185c4
BLAKE2b-256 checksum
How to use checksums
179fe2fae6971554940f3e8303ec93b8faf2c9b42964d4073bba11f54ad5052d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-win_amd64.whl

Download URL subspace_tunnel-0.1.0-py3-none-win_amd64.whl
Size 7.5 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
9d0aecc1376d09f058619f2da73faa4d1c24502f0a5f1f848fea6c63afe7ea08
BLAKE2b-256 checksum
How to use checksums
2757df148ccd8f4f8cfe8c57344920f930b1fd509772aa8af0843ac3379d2d5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-musllinux_1_2_x86_64.whl

Download URL subspace_tunnel-0.1.0-py3-none-musllinux_1_2_x86_64.whl
Size 7.3 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
5a3349a81f3c4a5a386f6cf7a285873429a606c3b452c58a67b08ff9be30629e
BLAKE2b-256 checksum
How to use checksums
1efa74a19713c49468dd98efd263556f9ce0dac4a7f550d2aa19d7fbab01e06c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-musllinux_1_2_aarch64.whl

Download URL subspace_tunnel-0.1.0-py3-none-musllinux_1_2_aarch64.whl
Size 6.8 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
2ffa83a0c2214e43f43870a4ab5db949212a38df27c04029209624b84cfd4c2e
BLAKE2b-256 checksum
How to use checksums
7acbcf92108a7dd624bea2b99e8b1925dcf762f6f54f8239f0183ecb429d125b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-manylinux_2_17_x86_64.whl

Download URL subspace_tunnel-0.1.0-py3-none-manylinux_2_17_x86_64.whl
Size 7.3 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
5342ada442a053a9567e4a0c3b179b221dbfe81452954be69347e123d74c34a8
BLAKE2b-256 checksum
How to use checksums
79769280e63157f7feb96dee29a01dfbe084bdf1826dd819d6e00a575f44cfc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-manylinux_2_17_aarch64.whl

Download URL subspace_tunnel-0.1.0-py3-none-manylinux_2_17_aarch64.whl
Size 6.8 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
e72f0882da1df8dbf2829dec2d40b456381dfc7e529f93757a686ddc9d114b06
BLAKE2b-256 checksum
How to use checksums
c03a4b1e92a6baddd7247821bd9747e1d27db627fe74bfa753f840dd02bb950e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-macosx_12_0_x86_64.whl

Download URL subspace_tunnel-0.1.0-py3-none-macosx_12_0_x86_64.whl
Size 7.4 MB
Tags Python 3 macOS 12.0+ x86-64
SHA-256 checksum
How to use checksums
68df8e78bdb40fde4ebf35f99e3f7a398aa91649fa8767a44fced14dc1b2a864
BLAKE2b-256 checksum
How to use checksums
9918e88bbd8b54167d5a9aa9a0498e3df830b9238519e5b6d9da5e4fb8359d82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Release files / subspace_tunnel-0.1.0-py3-none-macosx_12_0_arm64.whl

Download URL subspace_tunnel-0.1.0-py3-none-macosx_12_0_arm64.whl
Size 6.9 MB
Tags Python 3 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
cdb761f17f4a1d8bc96937037e9437bc4d27a80ce9c49caf9890ff89387af97d
BLAKE2b-256 checksum
How to use checksums
fad28e9bde2f509b23be36277ca7b91cf988af85a0832e6ddddcdd54938e12ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.5

Security for subspace-tunnel 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page