antimatter-gateway 2.0.4

Local edge gateway for the Antimatter ecosystem

⚛️ Antimatter Core

The Universal Multi-Agent Microservices Gateway

---

Antimatter is a hyper-secure, locally hosted, multi-agent integration gateway. It acts as an End-to-End Encrypted (E2EE) bridge between your mobile device and a suite of powerful AI Agents running on your desktop.

By decoupling the architecture, Antimatter allows you to seamlessly switch between different AI models (like Claude, Antigravity 2.0, or the Antigravity IDE) from a single Android application without compromising your local file system's security.

🚀 Features

• Multi-Agent Multiplexing: Connect to multiple AI adapters (Claude Desktop, AG2, etc.) simultaneously.
• End-to-End Encryption: 100% locally generated X25519/HKDF/AES-GCM encryption ensures your data is never readable by Cloudflare or any middleman.
• Dynamic Routing: Switch active agents on-the-fly directly from the Antimatter Android app.
• Headless & Secure Vaults: Built-in dual-layer secret storage using OS-native Keyrings and a headless AES-GCM fallback vault.

📦 Installation

To install the Antimatter Gateway, you can use either standard pip or uv:

Using pip:

pip install antimatter-gateway

Using uv (recommended for cleaner isolation):

uv tool install antimatter-gateway

Note: This package provides the core infrastructure for the Antimatter ecosystem.

💻 CLI Commands

Once installed, you have access to a suite of clean, simple terminal commands:

Command	Description
antimatter-gateway start	Starts the primary Gateway server silently as a background daemon.
antimatter-gateway stop	Safely kills the background Gateway daemon.
antimatter-gateway status	Checks if the Gateway daemon is running.
antimatter-gateway pair	Generates a secure QR code to pair your Android device.
antimatter-ag2	Starts the Antigravity 2.0 Adapter.
antimatter-claude	Starts the Claude Desktop Adapter.

🛠️ Quickstart

1. Start the Gateway:

   antimatter-gateway start
   

   The gateway now detaches and runs silently in the background. Logs are written to ~/.antimatter_daemon/gateway.log.

2. Pair your Device:

   antimatter-gateway pair
   

   Scan the generated QR code using the Antimatter Android App.

3. Start an Agent: Open a new terminal and start your preferred AI agent adapter:

   antimatter-ag2
   

4. Stop the Gateway (when finished):

   antimatter-gateway stop
   

📂 Workspace Whitelisting

By default, the Gateway restricts the mobile app's Workspace Explorer to only access the directory from which your adapter was started. To explicitly allow browsing and switching between specific directories, you can whitelist them in your config file (~/.antimatter_daemon/config.json):

{
    "allowed_workspaces": [
        "/home/user/my-project",
        "/home/user/another-project"
    ]
}

🔒 Security Architecture

Antimatter uses Cloudflare Quick Tunnels to expose the local gateway to the mobile app, but it treats the tunnel as an untrusted medium. All payloads are encrypted locally on the Android device using AES-GCM before transmission and are decrypted locally by the PC Gateway using a pre-shared Elliptic Curve Diffie-Hellman (ECDH) key exchange.