HyperChat

HyperChat is an open-source MCP-enabled chat client that integrates with multiple LLM APIs (OpenAI-style, including OpenAI, Claude/OpenRouter, Qwen, Deepseek, GLM, Ollama) and a rich set of productivity tools. It supports MCP extensions, agents, prompts, WebDAV sync, and advanced rendering (KaTeX, SVG, Mermaid) with a focus on multi-channel conversations via the HyperChat interface. You can run it locally using npx or via Docker, and connect MCP tools to orchestrate tasks across different LLMs and agents. Start by launching the server through npx: npx -y @dadigua/hyper-chat, which will boot on port 16100 by default and require a password of 123456 for Web UI access. Once running, you can access the Web UI at http://localhost:16100/123456/ and begin configuring MCP tools, agents, and prompts to orchestrate complex workflows across LLMs. The MCP integration allows you to define Tools and Agents, schedule tasks, and perform MCP calls within chat sessions, enabling advanced automation and knowledge-base-driven interactions. The CLI and web UI together let you manage conversations, render rich content (SVG, Mermaid, KaTeX), and leverage the Prompts/HyperPrompt features for dynamic parameterization and real-time previews.

Prerequisites:

• Node.js (for optional local npx usage) or Docker if you prefer containerized usage
• Internet access to fetch the package from npm

Option A — Install and run with npx (Node.js):

1. Ensure Node.js and npm are installed on your system.
2. Open a terminal and run: npx -y @dadigua/hyper-chat
3. The server will start on port 16100 by default (adjust via environment if needed). Access the UI at http://localhost:16100/123456/

Option B — Run with Docker (if you prefer containerized deployment):

1. Ensure Docker is installed and running.
2. Pull and run the HyperChat image: docker pull dadigua/hyperchat-mini:latest docker run -p 16100:16100 -e PORT=16100 -e PASSWORD=123456 --name hyperchat -i dadigua/hyperchat-mini:latest
3. Open http://localhost:16100/123456/ in your browser.

Notes:

• Default port is 16100 and default password is 123456; change these in env vars if needed.
• For development, you can clone the repository and run npm install then npm run dev as described in the project docs.

Tips and caveats:

• The MCP extension is built-in; to utilize Tools, Prompts, and Agents, configure MCP definitions within the HyperChat UI or config files provided by the project.
• If you run behind a firewall or require a custom port, adjust the PORT environment variable accordingly.
• When using Docker, ensure the container has network access to fetch LiM APIs if required by prompts.
• Keep an eye on the npm package version (@dadigua/hyper-chat) to stay aligned with MCP extensions and agent definitions.
• If you encounter authentication issues, confirm the Web UI URL and the password format; the default is 123456 unless overridden.