bitbang 0.1.0__tar.gz

bitbang-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rich LeGrand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bitbang-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: bitbang
+Version: 0.1.0
+Summary: Connect browsers to devices via WebRTC
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: aiortc
+Requires-Dist: websockets
+Requires-Dist: flask
+Requires-Dist: cryptography>=3.4
+Requires-Dist: qrcode>=7.0
+Requires-Dist: tomli>=1.0; python_version < "3.11"
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: uvicorn; extra == "fastapi"
+Dynamic: license-file

bitbang-0.1.0/README.md

@@ -0,0 +1,147 @@
+# BitBang
+
+BitBang exposes local web servers to the internet using WebRTC peer-to-peer connections. No account required, no monthly fee, no data routed through third-party servers.
+
+```
+pip install bitbang
+```
+
+## Quick demo
+
+```bash
+bitbang-fileshare ~/Downloads
+```
+
+This prints a URL and QR code. Anyone with the link can browse and download files directly from your machine. To verify it works outside your local network, scan the QR code from a phone on cellular.
+
+## Flask / FastAPI integration
+
+```python
+# Flask
+app = Flask(__name__)
+adapter = BitBangWSGI(app)
+adapter.run()  # Prints your public URL
+```
+
+```python
+# FastAPI
+app = FastAPI()
+adapter = BitBangASGI(app)
+adapter.run()
+```
+
+## Comparison
+
+| | ngrok | Cloudflare Tunnel | Tailscale | BitBang |
+|---|---|---|---|---|
+| Account required | Yes | Yes | Yes | No |
+| Free tunnels | 1 | Unlimited | Unlimited | Unlimited |
+| Data path | Their servers | Their servers | P2P | P2P |
+| Viewer needs install | No | No | Yes | No |
+| Configuration | CLI flags | Config file + DNS | Dashboard | None |
+
+BitBang's data path is direct between peers. The signaling server brokers the initial connection, then steps aside.
+
+---
+
+## Background
+
+The Internet is often thought of as a fully connected network — every machine is accessible from every other machine. But there are rules governing accessibility on the Internet. 
+
+### Rules of Internet Accessibility
+
+1. Machines on the Internet are accessible by other machines on the Internet — and by machines on your local network.
+2. Machines on your local network are only accessible by other machines on your local network.
+
+Because of rule 2, machines on your local network aren't reachable from outside — nor are the resources they hold: files, cameras, sensors, compute, or the web app you're currently developing. Cloud services exist to fill this gap: Dropbox for files, AWS IoT for sensors, Tailscale for compute, and ngrok for web apps — among others. These services apply rule 1, but each comes with the friction of account creation, monthly charges, and your data living on someone else's server.
+
+BitBang connects a browser directly to any machine on your local network, from anywhere on the Internet. No cloud intermediary, no account, no third party in the middle. It uses a novel application of the peer-to-peer technology WebRTC.
+
+### WebRTC
+
+WebRTC is the behind-the-scenes technology that makes Zoom and Google Meet video conferencing possible. WebRTC offers the highest bandwidth and lowest latency possible, which is important when you're streaming live video. It's mature, well-tested, and has ubiquitous support across all browsers. In addition to delivering low-latency media, it can also deliver raw data over "data channels", which is what BitBang uses.
+
+---
+
+## Examples
+
+The `examples/` directory contains two simple demos:
+
+```bash
+cd examples/simple_fastapi && python3 runapp.py
+cd examples/simple_flask && python3 runapp.py
+```
+
+Each prints a URL like `https://bitba.ng/6a1ccd1516a0ead5bd25c46b0bff14b3`, accessible from anywhere.
+
+## Fileshare
+
+Share files without uploading them to a third-party service:
+
+```bash
+bitbang-fileshare photo.jpg           # Share a single file
+bitbang-fileshare ~/Documents/project # Share a directory (uploads enabled)
+```
+
+Files transfer directly from your machine to the recipient.
+
+## Webcam
+
+The `webcam` app streams video to your browser using WebRTC media channels. It can be used as a simple easy-to-setup monitoring/security camera using your laptop, for example.
+
+```bash
+bitbang-webcam 
+```
+
+---
+
+## How it works
+
+Browsers normally connect to web servers over TCP. BitBang replaces this with a WebRTC data channel:
+
+![BitBang Python Block Diagram](assts/bitbang_python.png)
+
+The signaling server (`bitba.ng`) brokers the WebRTC handshake, then has no further involvement. It never sees application data.
+
+## Signaling server
+
+The signaling server source is available [here](https://github.com/richlegrand/bitbang-server). It:
+
+1. Serves the BitBang browser runtime
+2. Validates connecting servers via RSA challenge
+3. Maintains WebSocket connections to active servers
+4. Brokers ICE candidate and SDP exchange
+
+After the P2P connection is established, the signaling server is not involved.
+
+## Security
+
+WebRTC mandates encryption:
+
+- **Data channels**: DTLS 1.2+
+- **Media streams**: SRTP 
+- **Signaling**: HTTPS and WSS
+
+Furthermore, each BitBang server generates an RSA keypair. The public key hash becomes its unique ID, which is used in its BitBang public URL. The signaling server challenge-verifies key ownership before accepting connections.
+
+## Roadmap
+
+**proxybang** — A standalone binary that proxies any server on the local network. Run it once; the target is specified in the URL at browse-time.
+
+```
+https://bitban.ng/<proxy-id>/192.168.1.10:80
+https://bitban.ng/<proxy-id>/nas.local
+https://bitban.ng/<proxy-id>/octopi.local:5000
+```
+
+**ESP32 support** — Native BitBang for microcontrollers, including video streaming and OTA updates. It's an IoT network with no account set-up, subscription, etc. 
+
+---
+
+## License
+
+MIT
+
+## Contributing
+
+Issues and pull requests are welcome.

bitbang-0.1.0/bitbang/__init__.py

@@ -0,0 +1,11 @@
+# bitbang/__init__.py
+from .adapter import BitBangBase, BitBangWSGI, BitBangASGI
+from .identity import (
+    generate_identity,
+    load_or_create_identity,
+    uid_from_public_key,
+    sign_challenge,
+    verify_challenge,
+)
+
+__version__ = "0.1.0"

bitbang-0.1.0/bitbang/__main__.py

@@ -0,0 +1,20 @@
+# bitbang/__main__.py
+import sys
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python -m bitbang <command>")
+        print("Commands: webcam, files, send")
+        sys.exit(1)
+    
+    cmd = sys.argv[1]
+    if cmd == "webcam":
+        from bitbang.examples.webcam import run
+        run()
+    elif cmd == "send":
+        from bitbang.examples.send import run
+        run()
+    # etc
+
+if __name__ == "__main__":
+    main()