{"id":26641162,"url":"https://github.com/bigsweetpotatostudio/hyperchat","last_synced_at":"2025-05-14T23:06:33.946Z","repository":{"id":268381658,"uuid":"903270862","full_name":"BigSweetPotatoStudio/HyperChat","owner":"BigSweetPotatoStudio","description":"HyperChat is a Chat client that strives for openness, utilizing APIs from various LLMs to achieve the best Chat experience, as well as implementing productivity tools through the MCP protocol.","archived":false,"fork":false,"pushed_at":"2025-05-11T16:13:20.000Z","size":12367,"stargazers_count":570,"open_issues_count":15,"forks_count":57,"subscribers_count":8,"default_branch":"alpha","last_synced_at":"2025-05-14T23:06:17.815Z","etag":null,"topics":["agent","chat-application","llm","local-agent","mcp","modelcontextprotocol"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BigSweetPotatoStudio.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-14T06:46:41.000Z","updated_at":"2025-05-14T06:27:20.000Z","dependencies_parsed_at":"2024-12-16T12:35:20.496Z","dependency_job_id":"861bfced-5f80-47a3-93d9-6701d49d51ab","html_url":"https://github.com/BigSweetPotatoStudio/HyperChat","commit_stats":null,"previous_names":["bigsweetpotatostudio/hyperchat"],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigSweetPotatoStudio%2FHyperChat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigSweetPotatoStudio%2FHyperChat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigSweetPotatoStudio%2FHyperChat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigSweetPotatoStudio%2FHyperChat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BigSweetPotatoStudio","download_url":"https://codeload.github.com/BigSweetPotatoStudio/HyperChat/tar.gz/refs/heads/alpha","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254243361,"owners_count":22038046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","chat-application","llm","local-agent","mcp","modelcontextprotocol"],"created_at":"2025-03-24T18:19:58.286Z","updated_at":"2025-05-14T23:06:28.925Z","avatar_url":"https://github.com/BigSweetPotatoStudio.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[中文](README.zh.md) | [English](README.md)\n\n\n## Introduction\n\nHyperChat is an open-source Chat client that supports MCP and can utilize the APIs of various LLMs to achieve the best Chat experience and productivity tools.\n\n[![Build](https://github.com/BigSweetPotatoStudio/HyperChat/actions/workflows/build.yml/badge.svg)](https://github.com/BigSweetPotatoStudio/HyperChat/actions/workflows/build.yml)\n[![@dadigua/hyper-chat](https://img.shields.io/npm/v/%40dadigua%2Fhyper-chat)](https://www.npmjs.com/package/@dadigua/hyper-chat)\n[![npm downloads](https://img.shields.io/npm/dm/@dadigua/hyper-chat)](https://npm-stat.com/charts.html?package=@dadigua/hyper-chat)\n\n* Supports OpenAI style LLMs: `OpenAI`, `Claude(OpenRouter)`, `Qwen`, `Deepseek`, `GLM`, `Ollama`.\n* Fully supports MCP.\n\n## DEMO\n\n* [HyperChat](https://hyperchat.dadigua.men/123456/) on Docker\n\n## Features: \n\n- [x] **🪟Windows** + **🍏MacOS** + **Linux**\n- [x] Command line operation, `npx -y @dadigua/hyper-chat`, default port 16100, password 123456, Web access http://localhost:16100/123456/\n- [x] Docker \n    * Command line version `docker pull dadigua/hyperchat-mini:latest`\n    * Ubuntu desktop + Chrome + BrowserUse version (**coming soon**)\n- [x] `WebDAV` synchronization\n- [x] `MCP` extensions\n- [x] Supports dark mode🌙\n- [x] Resources, Prompts, Tools support\n- [x] Supports both English and Chinese\n- [x] Supports `Artifacts`, `SVG`, `HTML`, `Mermaid` rendering\n- [x] Supports defining Agents, can preset prompts, select permitted MCPs\n- [x] Supports scheduled tasks, designating Agents to complete tasks at specified times and view task completion status.\n- [x] Supports `KaTeX`, displaying mathematical formulas, code rendering with highlights and quick copy\n- [x] Added `RAG`, based on the MCP knowledge base\n- [x] Introduced ChatSpace concept, supports multi-conversation chatting\n- [x] Supports model comparison in chat\n\n### TODO:\n\n- Support official Claude protocol\n\n### LLM\n\n| LLM      | Usability    | Remarks                         |\n| -------- | ------ | -------------------------- |\n| claude   | ⭐⭐⭐⭐⭐  | No explanation                    |\n| openai   | ⭐⭐⭐⭐ | Also perfectly supports multi-step function calls (gpt-4o-mini also works) |\n| gemini flash 2.0   | ⭐⭐⭐⭐ | Very useful |\n| qwen       | ⭐⭐⭐⭐    | Very useful                 |\n| doubao       | ⭐⭐⭐    | Feels okay to use                   |\n| deepseek | ⭐⭐⭐      | Multi-step function calls may have issues       |\n\n## Usage\n\n* 1. Configure APIKEY, ensure that your LLM service is compatible with OpenAI style.\n* 2. Ensure that `uv + nodejs` and others are installed on your system.\n\n### [uvx \u0026 uv](https://github.com/astral-sh/uv)\n\nInstall via command line, or check the official Github tutorial [uv](https://github.com/astral-sh/uv)\n\n```\n# MacOS\nbrew install uv\n# windows\nwinget install --id=astral-sh.uv  -e\n```\n### [npx \u0026 nodejs](https://nodejs.org/en)\n\nInstall via command line, or download from the official site, official [nodejs](https://nodejs.org/en)\n```\n# MacOS\nbrew install node\n# windows\nwinget install OpenJS.NodeJS.LTS\n```\n\n## Development\n\n```\ncd electron \u0026\u0026 npm install\ncd web \u0026\u0026 npm install\nnpm install\nnpm run dev\n```\n\n## Telegram\n\n[HyperChat User Communication](https://t.me/dadigua001)\n\n#### Chat supports model comparison\n![image_2025-04-07_21-26-19](https://github.com/user-attachments/assets/e8691cd7-0518-4da8-90f2-7dfd8b864a09)\n![image](https://github.com/user-attachments/assets/c9cd15c8-9bce-4df9-b2b2-5fc4e9224ea6)\n\n#### Supports clicking tool name for direct invocation and debugging\n![image](https://github.com/user-attachments/assets/a9b22e98-d7b7-497a-93aa-c1501763fb8a)\n\n#### MCP tool prompts + Dynamic modification of LLM tool parameters\n![image](https://github.com/user-attachments/assets/080320e3-37d2-4f5a-ae3d-3517b3d692ad)\n\n#### Supports @ for quick input + Invoke Agent\n![17790cb3c686690e255462c7638b61f6](https://github.com/user-attachments/assets/12fd824c-cad7-4dd7-8df3-699c1da8d1cf)\n\n#### Supports `Artifacts`, `SVG`, `HTML`, `Mermaid` rendering,\n![image](https://github.com/user-attachments/assets/d823c671-e989-4f40-aadb-0bc0f3b35175)\n![image](https://github.com/user-attachments/assets/869b03fe-f025-4d6d-945c-8dac13d37ee0)\n\n#### Supports selecting MCP + selecting individual Tools\n![image](https://github.com/user-attachments/assets/9a297608-90be-4960-a4f1-ae627965486b)\n\n#### You can access from anywhere + any device via the Web, and set a password\n![image](https://github.com/user-attachments/assets/a9825e5b-da6d-4e0a-852f-177a3f6df992)\n\n#### Invokes terminal MCP to automatically analyze ASAR files + help unpack\n![image](https://github.com/user-attachments/assets/f9cc12cd-0c7e-4f2d-9649-4bb31240f4a6)\n\n#### Invokes terminal to view interface\n![image](https://github.com/user-attachments/assets/009317f2-d49b-432a-bb46-a15133d12f9f)\n\n#### Gaode Map MCP\n![image](https://github.com/user-attachments/assets/549e8fee-085d-4e8a-86a8-184ebe1053e6)\n\n#### One-click to write a webpage and publish to (Cloudflare)\n![image](https://github.com/user-attachments/assets/b558cf5c-8b07-4621-a95b-fa1c33181414)\n\n#### Invokes Google search, asking what the TGA Game of the Year is\n![image](https://github.com/user-attachments/assets/36500a06-2260-4727-bfd2-5fedc72e6d58)\n\n#### What are the limited-time free games? Please visit the website, invoke the tool\n![image](https://github.com/user-attachments/assets/8961ef09-1498-4730-b25d-75b1dedbc7e5)\n\n#### Opens the webpage, analyzes the results, and writes to a file\n![image](https://github.com/user-attachments/assets/a036dcf8-ffb4-4070-ac4f-a3b0533f66c2)\n\n#### Through web tools + command line tools, opens Github README to learn + GIT clone + sets up the development environment\n![image](https://github.com/user-attachments/assets/fd0d737e-0eaa-4410-85e0-27fd45f0e5a5)\n\n#### Multi-chat Workspace + Night Mode\n![image](https://github.com/user-attachments/assets/ca9d77d7-d023-431f-8359-6023ab3e338a)\n\n#### Scheduled task list + Scheduled message sending to Agent to complete tasks\n![image](https://github.com/user-attachments/assets/302a767c-bd00-48e4-ac41-5443d98a4708)\n\n#### Install MCP from third parties (supports any MCP) \n![image](https://github.com/user-attachments/assets/8580f194-139c-4d1c-b423-68627663232c)\n\n#### H5 interface\n![image](https://github.com/user-attachments/assets/e8349fb5-c98e-4fef-a93d-778079a27237)\n![image](https://github.com/user-attachments/assets/8a381114-6b26-4af2-90f2-270c0e85e819)\n![image](https://github.com/user-attachments/assets/b1487b6b-2cbc-46d8-ab1e-a335417c23ce)\n![image](https://github.com/user-attachments/assets/3a51dab9-375b-479b-8c6b-74a1be0dd037)\n\n#### Test the model's capabilities\n![image.png](./images/image48.png)\n\n#### Knowledge Base\n![image.png](./images/image50.png)\n\n## Disclaimer\n\n* This project is for learning and communication purposes only. If you use this project for any operation, such as web scraping, it is unrelated to the developers of this project.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsweetpotatostudio%2Fhyperchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigsweetpotatostudio%2Fhyperchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsweetpotatostudio%2Fhyperchat/lists"}