Skip to main content

route6

Python thin client for Route6.me — Python parity of @route6/agent.

Two surfaces:

  • CLIroute6 tunnel start --hostname X --to PORT exposes a localhost port at https://X.on.route6.me, plus a local MCP proxy at http://127.0.0.1:3000/mcp for Cursor / Claude Code / Cline / any MCP-aware editor.
  • Libraryfrom route6 import Route6 calls every MCP tool with typed Python ergonomics.

Install

pip install route6

Requires Python ≥ 3.10. Linux x64, macOS arm64 / x64 — tested matrix.

Quick start (CLI)

route6 login sk_a6_<your-api-key>

python3 -m http.server 3000 &

route6 tunnel start --hostname my-app --to 3000

In another terminal:

curl https://my-app.on.route6.me/
# → your local server's directory listing, served over the public internet.

The MCP proxy is also live at http://127.0.0.1:3000/mcp — point your editor at it.

Quick start (library)

from route6 import Route6

with Route6(api_key="sk_a6_...") as r6:
    ident = r6.tools.identity_get()
    print(ident["active_ipv6"], ident["prefix"])

    page = r6.tools.web_fetch(url="https://example.com")
    print(page["body"][:200])

Calls hit the public MCP at https://gw.route6.me/mcp over HTTP/2. The result is unwrapped — tools.web_fetch(...) returns the parsed dict the gateway produced, not the raw JSON-RPC envelope.

Available tools mirror the Node SDK and the container: identity_get, identity_set_ipv6, web_fetch, net_ping, hostname_register, team_chat, team_task, etc. — full list at https://docs.route6.me.

Commands

Command Purpose
route6 login <api_key> Save the API key to ~/.route6/config.json (mode 0600), verify against the gateway.
route6 logout Clear the stored key.
route6 status Print config + GET /whoami from the gateway.
route6 tunnel start --hostname X --to PORT Open inbound tunnel + start local MCP proxy. Pair --hostname and --to repeat-by-repeat for multi-host.
route6 tunnel start ... --no-mcp Tunnel only, skip the MCP proxy.
route6 mcp serve --port 3000 MCP-only mode (no inbound tunnel) — useful for hosted agents.

Tier comparison

Lite (this client) Pro (Docker container)
Install pip install route6 docker compose up
Outbound source IP Your /64 (preserved via the Route6 edge) Your /64 directly
Inbound to public hostname via gw.route6.me reverse tunnel direct to your container
Mesh between agents Not in v1 Native WireGuard
MCP tools All 28 All 28

Links

License

MIT © Route6 — the client is open source; the Route6 network service it connects to is a commercial product.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

route6-0.1.2.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

route6-0.1.2-py3-none-any.whl (17.7 kB view details)

Uploaded Python 3

File details

Details for the file route6-0.1.2.tar.gz.

File metadata

  • Download URL: route6-0.1.2.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for route6-0.1.2.tar.gz
Algorithm Hash digest
SHA256 b112f3c2829b88d150c81f874aba3b9355ad3c961dfdae6a4f7103f6ec01f017
MD5 1aee1ed9031cc9a5dd7e28828a88b2c2
BLAKE2b-256 044068c13797e1c3745fba4cde1badb001c51751c8b506b3f8b30f17a0f18e24

See more details on using hashes here.

File details

Details for the file route6-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: route6-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 17.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for route6-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 211ed5f9ca3b993c7ea8fbc9eddeae6d2c7aa76aed778995990e43e1eff552eb
MD5 91d5ec5bd09f09683f15b03e39f4157f
BLAKE2b-256 33ff96033aef8cec652192a79788424bbf9a20a2a9539a94e484134e1baa3e2e

See more details on using hashes here.

Release history Release notifications | RSS feed

1.1.0

1 file

1.0.0

2 files

This release

0.1.2 This release

2 files

0.1.0

2 files

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