Metadata-Version: 2.4
Name: torrus
Version: 0.1.2
Summary: Web-based SSH terminal that works behind any reverse proxy
Author-email: Anudeep Dhavaleswarapu <anudeepd2@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/anudeepd/torrus
Project-URL: Repository, https://github.com/anudeepd/torrus
Project-URL: Issues, https://github.com/anudeepd/torrus/issues
Keywords: ssh,terminal,web,xterm,remote
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Networking
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.110.0
Requires-Dist: python-socketio>=5.11.0
Requires-Dist: uvicorn[standard]>=0.29.0
Requires-Dist: paramiko>=3.4.0
Requires-Dist: aiofiles>=23.2.0
Requires-Dist: click>=8.1.0
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/anudeepd/torrus/main/assets/logo.svg" alt="Torrus" width="120"/>
</p>

<h1 align="center">Torrus</h1>

<p align="center">A web-based SSH terminal that works behind any reverse proxy. Install it, run it, use it.</p>

## Features

- **Web-based SSH terminal** with full xterm.js emulation
- **Multi-tab support** — open multiple SSH sessions side by side
- **Saved servers** — save, edit, import, and export connection configs
- **Works behind reverse proxies** — uses Socket.IO for reliable transport
- **Session sidebar** — quick-connect to saved servers

## Install

```bash
pip install torrus
```

## Usage

```bash
torrus serve
```

Opens the terminal in your browser. Connect to any SSH server from there.

Options:

```
--host TEXT     Bind host. [default: 0.0.0.0]
--port INTEGER  Bind port. [default: 8080]
--no-browser    Don't open the browser automatically.
```

## Development

Requires [uv](https://github.com/astral-sh/uv).

```bash
git clone https://github.com/anudeepd/torrus
cd torrus
uv sync
make dev
```

## License

MIT
