git404hub

what is umax fr?

ounezz/umax — explained in plain English

Analysis updated 2026-05-18

118TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

An unofficial TypeScript client for the MAX messenger, letting developers build bots that send messages, manage chats, and handle contacts.

vibe map

mindmap
  root((UMax))
    What it does
      Unofficial MAX client
      WebSocket connection
      Bot friendly events
    Tech stack
      TypeScript
      Node.js
      WebSocket
    Use cases
      Auto reply bots
      Manage chats
      Manage contacts
    Setup
      Node.js 24 plus
      Extract token manually
      npm install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Build an auto-reply bot for MAX that listens for incoming messages and responds automatically.

VIBE 2

Manage MAX chats and group members programmatically instead of through the official app.

VIBE 3

Automate contact management, such as adding, removing, or blocking contacts, on a MAX account.

VIBE 4

Send and edit messages, including photos and files, from a script or backend service.

what's the stack?

TypeScriptNode.jsWebSocket

how it stacks up fr

ounezz/umaxboona13/glb-shrinkmoney-takers/polymarket-arbitrage-trading-bot
Stars118119119
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Requires Node.js 24 or newer and manually extracting an authentication token from the MAX web app's browser console.

No license is stated in the README, so reuse and redistribution terms are unclear.

in plain english

UMax is an unofficial TypeScript client for MAX, a messenger app, letting a developer build a bot or automated client that connects to MAX over WebSocket. The README states plainly that the package is not affiliated with MAX or VK, it is a third-party project built by reading how the service works rather than an official integration. To use it, you first grab an authentication token from the MAX web app by opening its browser DevTools console and running a small helper script included in the project, then save that token in a local .env file. From there, a short piece of code creates a UMax client with the token, listens for events such as incoming messages, and calls connect to start the session. Once connected, the client exposes account details like your profile name, description, and avatar, and lets you change them. It fires events for messages being sent, edited, or deleted, and supports sending, replying to, editing, deleting, marking as read, and reacting to messages, including ones with photos or files attached. It can also list and manage chats, including both one-on-one conversations and groups, view group members, and create new groups, as well as list contacts and add, remove, block, or unblock them. The project requires Node.js version 24 or newer and is installed as an npm package. Full documentation for each feature area, covering setup, account handling, events, messages, chats, and contacts, is included in the repository's documentation folder. Because the token has to be pulled manually from the browser rather than through an official login flow, using this client means relying on a value meant for the official web app rather than a supported developer credential. The README does not mention a license, so the terms under which the code itself can be reused are not stated.

prompts (copy fr)

prompt 1
Help me extract a MAX authentication token using the console script included in this project.
prompt 2
Write a UMax bot that auto-replies to any message that isn't from my own account.
prompt 3
Explain how to listen for message_edit and message_delete events with this client.
prompt 4
Show me how to create a new group chat and add contacts to it using this library.

Frequently asked questions

what is umax fr?

An unofficial TypeScript client for the MAX messenger, letting developers build bots that send messages, manage chats, and handle contacts.

What language is umax written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, WebSocket.

What license does umax use?

No license is stated in the README, so reuse and redistribution terms are unclear.

How hard is umax to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is umax for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.