Documentation

Noxy Network Documentation

Add human-in-the-loop to your AI agents. Encrypted decision requests, multichannel delivery, post-quantum-ready security, and SDKs in eight languages and runtimes.

What is Noxy?

Noxy delivers actionable, end-to-end encrypted decision requests from your AI agent to your users — on iOS, Android, web, or Telegram. Users approve or reject in seconds and your agent gets the answer back over a single gRPC call.

Noxy is not a generic push-notification network and not an execution layer for agent logic. It is the secure transport between an agent backend and the humans who must remain in the loop when stakes are high.

How it works in 30 seconds

  1. Your agent calls sendDecision() through an Agent SDK with the user's identity and a JSON payload that describes the proposed action.
  2. The Noxy relay encrypts the payload to every device registered for that identity and delivers it. If a device is offline, a silent push wakes it up.
  3. The user sees the decision in your client app and chooses Approve or Reject.
  4. Your agent receives the terminal outcome — APPROVED, REJECTED, or EXPIRED — and continues.

Heads up The decision payload is encrypted on the agent side before it leaves your process. The relay forwards ciphertext and never sees the plaintext you send to your users.

Where to go next

Framework connectors

If you build agents with LangGraph or LangChain, the connectors wrap the Python Agent SDK as a drop-in graph node or HITL middleware — your agent suspends on interrupt(), the user approves on any device, and a webhook resumes the run.

Two SDK families

Noxy ships with two complementary SDK families. Agent SDKs live in your backend and call RouteDecision. Client SDKs live in your user-facing app and receive, decrypt, and answer the decisions.

FamilyWhere it runsWhat it doesLanguages
Agent SDKBackend / agent processRoutes encrypted decisions, polls outcomes, reads quotaNode.js, Python, Go, Rust
Client SDKUser device or chat surfaceRegisters the device, decrypts decisions, sends outcomesBrowser, iOS, Android, Telegram Bot