Skip to content

GATEDeepSync/DeepSyncBridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DeepSync Bridge Protocol

Any AI. Any Model. One Uncompromising Trust Layer.

The Silent, Seamlessly Integratable Collaborator for Your AI Pipeline.

Version License Python Docker Gemma Tailscale


"It doesn't matter which AI you're talking to or using. As long as both sides use DeepSync Bridge — the communication is cryptographically verified, sealed, and trusted. By design."


→ Get the MasterKit — $69.95   |   Documentation   |   Quick Start   |   FAQ


The Problem No One Is Talking About

AI models are talking to each other right now — on your phone, on your PC, across networks you don't fully control.

Do you know if the message that arrived is the message that was sent?

Most pipelines don't. Inference results travel between AI models unsigned, unverified, and unauthenticated. A single tampered byte in transit — a man-in-the-middle, a proxy, a bad network hop — and your application has no way to know. The AI on the receiving end processes corrupted data and responds with confidence.

This is not a theoretical problem. It is the default state of every local AI pipeline running today.

DeepSync Bridge Protocol fixes it — for any AI, talking to any other AI, over any network.


What DeepSync Does

DeepSync deploys a cryptographic enforcement sidecar between every AI model endpoint in your pipeline. It doesn't matter if you're running Gemma, LLaMA, Claude, GPT, or your own fine-tuned model. It doesn't matter if your AI is on a phone, a laptop, or a server.

Before any data leaves a trust boundary, DeepSync:

  • Signs it — ECDSA P-256 signature, proving exactly which device sent it
  • Hashes it — SHA-256 integrity check, proving not one byte was altered in transit
  • Seals the session — A mandatory mutual handshake enforced at the transport layer, with no configuration to skip it

When data arrives, DeepSync runs those three checks independently. All three must pass. There is no configuration that skips any of them.

If a message exits DeepSync — it is verified. If it isn't verified — it doesn't exit.


Two Ways to Use DeepSync

🔌 Mode 1 — Drop It In. Secure Everything.

Already have AI talking to AI? Point your existing pipeline at the DeepSync Gatekeeper instead of your model endpoint. Zero changes to your models. Zero changes to your workflow. 15 minutes from download to protected.

Every message in your existing pipeline is now signed, verified, and sealed. You didn't rebuild anything. You just made everything trustworthy.

🤝 Mode 2 — The Silent, Seamlessly Integratable Collaborator

This is where it gets extraordinary.

DeepSync doesn't just secure the pipe — it becomes the orchestration layer. Your phone's AI can silently recruit your PC's more powerful model, which can call Gemini for an image, query an API, run a computation — and return one seamless verified response. The user sees a result. They never see the seams.

📱 "Make me something beautiful"
         ↓
📱 Gemma 4 e2b   →  "I'll ask the bigger model"  →  ⬡ DeepSync
🖥️ Gemma 4 e4b   →  "I'll craft the perfect prompt" →  🎨 Gemini Imagen
🎨 Imagen        →  [generates image]              →  🖥️ Gemma 4 e4b
🖥️ Gemma 4 e4b   →  "Here's what I made for you"  →  ⬡ DeepSync
📱 Edge Gallery  →  🌸 [flower appears — VERIFIED]

Every hop in that chain — verified. Every model that touched the request — authenticated. Every byte that moved — signed.

That's not just a security layer. That's trust infrastructure for multi-model AI.

No other AI orchestration protocol — not LangChain, not Open Interpreter, not AutoGen — can prove cryptographically that the result you received came from exactly the models you asked, unmodified, in exactly the order it happened. DeepSync can.


The power of DeepSync is not that it works with one AI. It's that it works with all of them — simultaneously, in the same pipeline.

📱 Google Edge Gallery     ⬡ DeepSync           🖥️ LM Studio
   (Gemma 4 e2b)     ────► Gatekeeper  ────►   (Gemma 4 e4b)
   ECDSA Signed            VERIFIED ONLY        Signed Response
                           ↕ BOTH WAYS ↕
📱 Any AI Client           ⬡ DeepSync           🖥️ Any AI Model
   (Claude / GPT / Llama)  Gatekeeper     (Ollama / LM Studio / API)
   ECDSA Signed     ─────► VERIFIED ONLY ─────► Signed Response

The rule is simple: if both sides of a conversation run DeepSync Bridge, the communication is completely verified — regardless of which AI models are involved.


Model Compatibility

Model Provider Status
Gemma 4 (e2b / e4b) Google ✅ Optimised — debut platform
Gemini (Pro / Flash / Ultra) Google DeepMind ✅ Compatible
LLaMA 3 (local / on-prem) Meta ✅ Compatible
Claude (Sonnet / Haiku) Anthropic ✅ Compatible
GPT-4 / o-series OpenAI ✅ Compatible
Any OpenAI-compatible API ✅ Compatible
Any model producing UTF-8 output ✅ Compatible

The Three Guarantees

🔒 Payload Sealing

Every outgoing message is bound to a session nonce, a sequence counter, and a temporal attestation stamp before it enters the trust boundary. The sealed envelope is designed so that any modification, replay, or inspection attempt by a party outside the Gatekeeper invalidates the entire envelope — silently. No error is exposed to an attacker.

🔑 Cryptographic Handoff

ECDSA P-256 signing on every packet. SHA-256 integrity verification runs independently of authentication — passing one check does not bypass the other. Ephemeral session keys are derived during the handshake, held only in volatile runtime memory, never written to disk, and gone the moment the session ends.

🤝 Mandatory Handshake

No frame crosses the boundary without a completed mutual authentication handshake. This gate is enforced at the transport layer — before any application logic runs, before any model sees any data. A client that fails the handshake receives silence — not an error. Minimal attack surface by design.


Architecture

┌─────────────────────────────────────────────────────────────┐
│                    TAILSCALE PRIVATE MESH                   │
│                  (never reachable from internet)            │
│                                                             │
│  📱 Phone               ⬡ DeepSync               🖥️  PC    │
│  ┌─────────┐    sign   ┌──────────────┐  verified ┌──────┐ │
│  │  Client │ ────────► │  Gatekeeper  │ ─────────► │  LM  │ │
│  │(Termux /│           │   Sidecar    │            │Studio│ │
│  │EdgeGall)│ ◄──────── │  [BLACK BOX] │ ◄───────── │Gemma │ │
│  └─────────┘  verified └──────────────┘   signed   └──────┘ │
│                              │                              │
│                    FRAME_ACCEPTED                           │
│                    FRAME_DELIVERED                          │
│                    SESSION_ESTABLISHED                      │
└─────────────────────────────────────────────────────────────┘

The Gatekeeper operates as a Proprietary Black Box Runtime. Its internal implementation is intentionally opaque. You interact with two observable events — FRAME_ACCEPTED and FRAME_DELIVERED — and the guarantee they carry. The internal mechanisms are the black box.


See It In Action

The Secure Tunnel — Zero-Trust Enforcement

Architecture Overview

Phone → Tailscale → DeepSync Gatekeeper → LM Studio. Every packet signed and verified at every hop.


Docker Desktop — Live Security Events

Docker Security Log

Every request produces a visible, auditable security log. You can see exactly when authentication passed, when integrity was verified, and when the signed response was dispatched.


Phone Terminal — What the User Sees

Phone Verified Output

The phone client shows a real-time progress spinner while the remote AI works. When the verified response arrives, it displays in color with the [✓ VERIFIED] confirmation — proving the response came from your model, unmodified.


Why Not Just Use TLS?

This is the first question every engineer asks. It's the right question.

TLS DeepSync
Encrypts the channel
Verifies payload integrity ✅ ECDSA + SHA-256
Per-packet sender authentication ✅ Registered key registry
Mandatory transport-layer gate ✅ Enforced by design
Model-agnostic ✅ Any UTF-8 output
Works offline / local-only
Replay attack protection ✅ Nonce-bound sealed frames
Silent failure on auth breach ✅ Zero error surface exposed

TLS secures the pipe. DeepSync secures what flows through it.

A TLS connection tells you the channel is encrypted. It tells you nothing about whether the AI model on the other end is the one you think it is, or whether the payload it sent was modified between signing and arrival. DeepSync answers both questions — for every single packet.


Quick Start

Prerequisites: Docker Desktop · Python 3.9+ · Tailscale · LM Studio · Termux (Android) Time to first verified message: ~15 minutes

Windows

# Double-click Install.bat — or run from PowerShell:
.\Install.bat

macOS and Linux support coming in a future release.

The installer generates your cryptographic key pairs, builds the Docker container, verifies the LM Studio connection, and prints your Tailscale IP with exact phone setup commands.

Phone (Termux) — After Running the Installer

# 1. Verify the full pipeline end-to-end
python client.py --host 100.x.x.x --port 8080 --mode test
# Expected output:  STATUS: ROUTED | RESPONSE VERIFIED: YES

# 2. Start chatting securely
python client.py --host 100.x.x.x --port 8080
# You:    Hello — is this connection verified?
# [✓ VERIFIED] Gemma: Yes. Your message arrived signed and integrity-checked.

⚠️ Important — pip and --break-system-packages

If you are installing on Android (Termux), Linux, or macOS, you may see this error:

error: externally-managed-environment
× This environment is externally managed
hint: pip install <package> --break-system-packages

This is safe to resolve. Here is why:

The --break-system-packages flag tells pip to bypass the OS package manager's lock on the Python environment. Despite the alarming name, it does not break your phone, your PC, or any system files. Inside Termux (a sandboxed Android terminal) or a Docker container, there is no OS-managed Python to protect.

The fix:

pip install -r requirements.txt --break-system-packages

The automated scripts (install.bat, setup_termux.sh) already include this flag. You will only see this error if running pip commands manually.


What's in the MasterKit

DeepSync_Bridge_MasterKit_v1.1/
├── Windows/
│   ├── Install.bat              ← one-click installer (run this first)
│   ├── Uninstall.bat            ← clean reset (Soft or Full mode)
│   ├── gateway.py               ← the Gatekeeper sidecar (zero-trust enforcement)
│   ├── keygen.py                ← ECDSA P-256 key pair generator
│   ├── Dockerfile               ← production multi-stage build
│   ├── docker-compose.yml       ← container orchestration
│   └── requirements.txt         ← Python dependencies
├── Android/
│   ├── client.py                ← phone client (run inside Termux)
│   ├── setup_termux.sh          ← one-command Termux environment setup
│   └── run_test.sh              ← end-to-end pipeline verification test
└── Documentation/
    ├── README_FIRST.txt         ← start here — prerequisites + install order
    └── screenshots/             ← reference screenshots of every window
        ├── architecture.png     ← system overview
        ├── docker_logs.png      ← what Docker Desktop should show
        └── phone_verified.png   ← what the phone terminal should show

OpenWebUI Integration

Point OpenWebUI at the DeepSync sidecar instead of LM Studio directly:

Settings → Connections → Add OpenAI connection

URL:     http://YOUR_TAILSCALE_IP:8080
API Key: any value

Full streaming support included. Every response is verified by the Gatekeeper before delivery.


FAQ

Q: Does DeepSync work if only one side of the conversation uses it? A: Yes — one side is the minimum. The Gatekeeper will authenticate incoming packets from any registered device and sign all outgoing packets. Both sides using DeepSync gives you full bilateral verification.

Q: Does this work with cloud AI APIs (Gemini, GPT-4, Claude)? A: Yes. If the API returns a UTF-8 string, DeepSync can seal and verify it. The Gatekeeper is model-agnostic by design.

Q: Do I need a cloud account or subscription to use DeepSync? A: No. DeepSync runs entirely on your own hardware. The only external service is Tailscale (which is free for personal use) to create the private network between your devices.

Q: What happens if the authentication check fails? A: The packet is dropped immediately and a SECURITY ALERT is written to the container log. No error is returned to the sender — they receive silence. This is intentional zero-trust design.

Q: Is this a one-time purchase? A: Yes. $69.95, one time. No subscription. No license key server. The MasterKit is yours forever and works offline.

Q: What support is included? A: Full documentation, troubleshooting guide, and the complete source kit. Community support via GitHub Issues.


Documentation

Resource Description
User Setup Guide Step-by-step for non-technical users — Phases 1–4
Edge Gallery Guide Complete Google Edge Gallery → LM Studio connection walkthrough
Protocol Specification ECDSA architecture, packet schema, Black Box §7
Troubleshooting Every error code with a plain-English fix

(Full interactive documentation available with the MasterKit purchase.)


Roadmap

✅ v1.0.0 — Available Now

  • Cryptographic enforcement sidecar (ECDSA P-256 + SHA-256)
  • Mandatory mutual handshake — enforced at the transport layer
  • Phone ↔ PC verified AI communication
  • Model-agnostic — any UTF-8 output, any AI
  • Docker-based deployment — one-click installer on Windows
  • OpenWebUI compatible
  • 30-day money-back guarantee

✅ v1.1.0 — Shipped

  • Web Search Orchestration — Gateway detects search intent, queries DuckDuckGo, injects results as context before calling LM Studio
  • Media Request Acknowledgment — Image/video/audio requests return an immediate verified acknowledgment
  • Phone Progress Spinner — Animated real-time indicator while the remote AI works
  • Extended Timeout Handling — Gunicorn workers hardened for long-running reasoning model responses

🔄 v1.2 — In Development

  • AI Tool Orchestration — Let your AI call Gemini, DALL-E, search APIs, and custom tools
  • Image Generation Pipeline — Phone asks → AI thinks → Gemini creates → verified image returns
  • Multi-Agent Verified Chains — Cryptographic proof across any number of collaborating models
  • Silent Background Collaboration — The user sees one answer. Multiple models built it. Nobody sees the seams.

🔮 v2.0 — On the Horizon

  • macOS and Linux installer
  • Mobile-native client (no Termux required)
  • Web dashboard for pipeline visualization
  • Enterprise key management and audit logs

About the Developer

DeepSync Bridge Protocol was built by a software engineer with 24 years of enterprise development experience — not as an academic exercise, but informed by a career spent in environments where data integrity failure carries real consequences.

  • 🏥 GE HealthCare — enterprise systems engineering in one of the world's most regulated industries
  • 🩺 WelchAllyn — software architecture for the CVSM 6000 clinical medical device, where data trust is a patient safety requirement
  • ⚖️ HarrisBeach PLLC — data infrastructure for a major law firm, where confidentiality is the foundation of the entire practice
  • 🎓 Syracuse University — institutional-scale systems engineering and SDLC standards development
  • 🏗️ FLUOR — enterprise-scale SQL and reporting infrastructure for one of the world's largest engineering firms

Having spent two decades building production systems inside healthcare, legal, and enterprise environments — where the cost of a broken trust assumption is measured in real-world impact — DeepSync is the protocol I wished existed every time I had to answer the question: "How do we know the data that arrived is the data that was sent?"

"I didn't build DeepSync because it was an interesting idea. I built it because I've seen what happens in production systems when the answer to that question is 'we don't.'"

X / Twitter Gumroad


DeepSync Bridge Protocol v1.1.0 OMalleyCorp.LLC

"It doesn't matter which AI you're talking to. As long as both sides use DeepSync Bridge — the communication is verified."


Buy Now

No subscription. No cloud dependency. Yours forever.

Releases

No releases published

Packages

 
 
 

Contributors