janus-remote 0.7.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. janus_remote-0.7.2/LICENSE +21 -0
  2. janus_remote-0.7.2/PKG-INFO +124 -0
  3. janus_remote-0.7.2/README.md +97 -0
  4. janus_remote-0.7.2/janus_remote/__init__.py +18 -0
  5. janus_remote-0.7.2/janus_remote/cli.py +508 -0
  6. janus_remote-0.7.2/janus_remote/pty_capture.py +557 -0
  7. janus_remote-0.7.2/janus_remote.egg-info/PKG-INFO +124 -0
  8. janus_remote-0.7.2/janus_remote.egg-info/SOURCES.txt +12 -0
  9. janus_remote-0.7.2/janus_remote.egg-info/dependency_links.txt +1 -0
  10. janus_remote-0.7.2/janus_remote.egg-info/entry_points.txt +4 -0
  11. janus_remote-0.7.2/janus_remote.egg-info/requires.txt +1 -0
  12. janus_remote-0.7.2/janus_remote.egg-info/top_level.txt +1 -0
  13. janus_remote-0.7.2/pyproject.toml +45 -0
  14. janus_remote-0.7.2/setup.cfg +4 -0
janus_remote-0.7.2/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 He Who Seeks
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
janus_remote-0.7.2/PKG-INFO ADDED
@@ -0,0 +1,124 @@
1
+ Metadata-Version: 2.4
2
+ Name: janus-remote
3
+ Version: 0.7.2
4
+ Summary: Voice-to-text paste bridge for Claude CLI on remote SSH sessions
5
+ Author: He Who Seeks
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/anthropics/janus
8
+ Project-URL: Repository, https://github.com/anthropics/janus
9
+ Keywords: claude,voice,ssh,remote,paste,janus
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Environment :: Console
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Operating System :: POSIX :: Linux
14
+ Classifier: Operating System :: MacOS
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.8
17
+ Classifier: Programming Language :: Python :: 3.9
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
22
+ Requires-Python: >=3.8
23
+ Description-Content-Type: text/markdown
24
+ License-File: LICENSE
25
+ Requires-Dist: websocket-client>=1.0.0
26
+ Dynamic: license-file
27
+
28
+ # janus-remote
29
+
30
+ Voice-to-text paste bridge for Claude CLI on remote SSH sessions.
31
+
32
+ Use your voice to interact with Claude CLI running on remote servers, with transcriptions pasted directly into the terminal - no window switching needed!
33
+
34
+ ## Installation
35
+
36
+ ```bash
37
+ pip install janus-remote
38
+ ```
39
+
40
+ ## Requirements
41
+
42
+ 1. **Local Mac**: Janus Electron app running (provides voice recognition + WebSocket server)
43
+ 2. **SSH Config**: Port forwarding enabled (one-time setup)
44
+
45
+ ## SSH Setup (One-Time)
46
+
47
+ Add this to your `~/.ssh/config` on your **local Mac**:
48
+
49
+ ```
50
+ Host *
51
+ RemoteForward 9473 localhost:9473
52
+ ```
53
+
54
+ Or for specific hosts:
55
+
56
+ ```
57
+ Host myserver
58
+ HostName myserver.example.com
59
+ RemoteForward 9473 localhost:9473
60
+ ```
61
+
62
+ This forwards the Janus WebSocket bridge (port 9473) to the remote server.
63
+
64
+ ## Usage
65
+
66
+ On your remote server via SSH:
67
+
68
+ ```bash
69
+ # Start a new Claude session with voice paste support
70
+ claude-janus
71
+
72
+ # Resume a previous session
73
+ claude-janus --resume
74
+ claude-janus -r
75
+ ```
76
+
77
+ ## How It Works
78
+
79
+ ```
80
+ LOCAL MAC REMOTE SERVER (via SSH)
81
+ ┌─────────────────────┐ ┌─────────────────────┐
82
+ │ Janus Electron │ │ claude-janus │
83
+ │ (Voice Recognition) │ │ (This package) │
84
+ │ │ │ │ │ │
85
+ │ ▼ │ │ │ │
86
+ │ WebSocket :9473 ────┼─────────────┼───────► │ │
87
+ │ │ SSH Tunnel │ ▼ │
88
+ │ │ │ Inject into PTY │
89
+ └─────────────────────┘ └─────────────────────┘
90
+ ```
91
+
92
+ 1. Speak into your Mac's microphone
93
+ 2. Janus transcribes and sends via WebSocket
94
+ 3. SSH tunnel forwards to remote server
95
+ 4. `claude-janus` receives and injects text directly into Claude CLI
96
+
97
+ ## Features
98
+
99
+ - **Sexy Terminal Banner**: Claude + Janus ASCII art on startup 🔮
100
+ - **Voice Paste**: Speak on your Mac → text appears in remote terminal
101
+ - **Approval Overlay**: Claude permission requests show on your local Mac overlay
102
+ - **Zero latency feel**: WebSocket connection, no polling
103
+ - **Background paste**: No window switching - text appears directly in terminal
104
+ - **Multi-session support**: Run multiple `claude-janus` sessions on different servers
105
+ - **Auto-reconnect**: Handles connection drops gracefully
106
+
107
+ ## Troubleshooting
108
+
109
+ ### "Bridge connection failed"
110
+ - Ensure Janus Electron is running on your local Mac
111
+ - Verify SSH port forwarding is configured
112
+ - Check that port 9473 isn't blocked
113
+
114
+ ### "Could not find 'claude' binary"
115
+ - Install Claude CLI: `npm install -g @anthropic-ai/claude-cli`
116
+ - Or ensure it's in your PATH
117
+
118
+ ## License
119
+
120
+ MIT
121
+
122
+ ## Author
123
+
124
+ He Who Seeks
janus_remote-0.7.2/README.md ADDED
@@ -0,0 +1,97 @@
1
+ # janus-remote
2
+
3
+ Voice-to-text paste bridge for Claude CLI on remote SSH sessions.
4
+
5
+ Use your voice to interact with Claude CLI running on remote servers, with transcriptions pasted directly into the terminal - no window switching needed!
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ pip install janus-remote
11
+ ```
12
+
13
+ ## Requirements
14
+
15
+ 1. **Local Mac**: Janus Electron app running (provides voice recognition + WebSocket server)
16
+ 2. **SSH Config**: Port forwarding enabled (one-time setup)
17
+
18
+ ## SSH Setup (One-Time)
19
+
20
+ Add this to your `~/.ssh/config` on your **local Mac**:
21
+
22
+ ```
23
+ Host *
24
+ RemoteForward 9473 localhost:9473
25
+ ```
26
+
27
+ Or for specific hosts:
28
+
29
+ ```
30
+ Host myserver
31
+ HostName myserver.example.com
32
+ RemoteForward 9473 localhost:9473
33
+ ```
34
+
35
+ This forwards the Janus WebSocket bridge (port 9473) to the remote server.
36
+
37
+ ## Usage
38
+
39
+ On your remote server via SSH:
40
+
41
+ ```bash
42
+ # Start a new Claude session with voice paste support
43
+ claude-janus
44
+
45
+ # Resume a previous session
46
+ claude-janus --resume
47
+ claude-janus -r
48
+ ```
49
+
50
+ ## How It Works
51
+
52
+ ```
53
+ LOCAL MAC REMOTE SERVER (via SSH)
54
+ ┌─────────────────────┐ ┌─────────────────────┐
55
+ │ Janus Electron │ │ claude-janus │
56
+ │ (Voice Recognition) │ │ (This package) │
57
+ │ │ │ │ │ │
58
+ │ ▼ │ │ │ │
59
+ │ WebSocket :9473 ────┼─────────────┼───────► │ │
60
+ │ │ SSH Tunnel │ ▼ │
61
+ │ │ │ Inject into PTY │
62
+ └─────────────────────┘ └─────────────────────┘
63
+ ```
64
+
65
+ 1. Speak into your Mac's microphone
66
+ 2. Janus transcribes and sends via WebSocket
67
+ 3. SSH tunnel forwards to remote server
68
+ 4. `claude-janus` receives and injects text directly into Claude CLI
69
+
70
+ ## Features
71
+
72
+ - **Sexy Terminal Banner**: Claude + Janus ASCII art on startup 🔮
73
+ - **Voice Paste**: Speak on your Mac → text appears in remote terminal
74
+ - **Approval Overlay**: Claude permission requests show on your local Mac overlay
75
+ - **Zero latency feel**: WebSocket connection, no polling
76
+ - **Background paste**: No window switching - text appears directly in terminal
77
+ - **Multi-session support**: Run multiple `claude-janus` sessions on different servers
78
+ - **Auto-reconnect**: Handles connection drops gracefully
79
+
80
+ ## Troubleshooting
81
+
82
+ ### "Bridge connection failed"
83
+ - Ensure Janus Electron is running on your local Mac
84
+ - Verify SSH port forwarding is configured
85
+ - Check that port 9473 isn't blocked
86
+
87
+ ### "Could not find 'claude' binary"
88
+ - Install Claude CLI: `npm install -g @anthropic-ai/claude-cli`
89
+ - Or ensure it's in your PATH
90
+
91
+ ## License
92
+
93
+ MIT
94
+
95
+ ## Author
96
+
97
+ He Who Seeks
janus_remote-0.7.2/janus_remote/__init__.py ADDED
@@ -0,0 +1,18 @@
1
+ """
2
+ Janus Remote - Voice-to-text paste bridge for Claude CLI on remote SSH sessions
3
+
4
+ Usage:
5
+ pip install janus-remote
6
+ claude-janus # Start Claude with voice paste support
7
+
8
+ Requires:
9
+ - Janus Electron app running on your local Mac
10
+ - SSH port forwarding: RemoteForward 9473 localhost:9473
11
+ """
12
+
13
+ __version__ = "0.2.0"
14
+ __author__ = "He Who Seeks"
15
+
16
+ from .pty_capture import main as run_pty_capture
17
+
18
+ __all__ = ["run_pty_capture", "__version__"]