ChatPulse CLI

Terminal-based client for ChatPulse — a real-time messaging platform powered by Kafka.

Install

macOS / Linux (auto-installs pipx if missing, no system-package or PATH fiddling):

curl -sSL https://chatpulse.online/install.sh | bash

Windows (PowerShell — auto-installs pipx if missing):

powershell -ExecutionPolicy Bypass -c "irm https://chatpulse.online/install.ps1 | iex"

Any OS (pipx required — see Prerequisites):

pipx install chatpulse-cli

The CLI installs into an isolated pipx environment, so it never touches your system Python.

Quick Start

# Register a new account
chatpulse auth register username your@email.com

# Login
chatpulse auth login username

# List rooms
chatpulse rooms list

# Start chatting in room 1
chatpulse chat 1

Features

• JWT-based authentication
• Room creation, listing, joining, leaving
• Real-time message sending and polling
• Interactive chat mode
• Persistent config across sessions

Requirements

Python 3.10+

Prerequisites

• Python 3.10+ — install from https://python.org/downloads if missing.
• pipx — the install scripts bootstrap it automatically (via your package manager, or into an isolated fallback environment; they never use --break-system-packages). To install it yourself: brew install pipx (macOS), sudo apt install pipx (Debian/Ubuntu), or python3 -m pip install --user pipx.
• Windows — interactive chatpulse chat requires WSL; all other commands run natively in PowerShell.