{"id":26501887,"url":"https://github.com/BigSweetPotatoStudio/HyperChat","last_synced_at":"2025-03-20T17:03:42.222Z","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-03-14T18:12:57.000Z","size":6011,"stargazers_count":289,"open_issues_count":6,"forks_count":31,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-14T18:37:25.691Z","etag":null,"topics":["chat-application","llm","mcp","modelcontextprotocol"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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}},"created_at":"2024-12-14T06:46:41.000Z","updated_at":"2025-03-14T18:31:44.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":34,"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/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244656704,"owners_count":20488638,"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":["chat-application","llm","mcp","modelcontextprotocol"],"created_at":"2025-03-20T17:01:58.597Z","updated_at":"2025-03-20T17:03:42.216Z","avatar_url":"https://github.com/BigSweetPotatoStudio.png","language":"JavaScript","readme":"[中文](README.zh.md) | [English](README.md)\n\n\n## Introduction\n\nHyperChat is an open pursuit Chat client that can use APIs from various LLMs, fully supporting MCP to achieve the best chat experience, as well as a production MAX tool based on native Agents.\n\n[![Build](https://github.com/BigSweetPotatoStudio/HyperChat/actions/workflows/build.yml/badge.svg)](https://github.com/BigSweetPotatoStudio/HyperChat/actions/workflows/build.yml)\n[![npm version](https://img.shields.io/npm/v/@dadigua/hyper-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* Built-in MCP plugin marketplace, user-friendly MCP installation configuration, one-click installation. Contributions to [HyperChatMCP](https://github.com/BigSweetPotatoStudio/HyperChatMCP) are welcome.\n* Also supports manual installation of third-party MCPs; just fill in `command`, `args`, `env`.\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 execution, `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/hyper-chat-mini:1.2.8`\n    * Ubuntu desktop + Chrome + BrowserUse version (**coming soon**)\n- [x] `MCP` extension marketplace + third-party MCP support\n- [x] Supports free creation and design of `Agent`, with preset prompts and selection of MCP features\n- [x] Supports dark mode🌙\n- [x] Resources, Prompts, Tools support\n- [x] Supports English and Chinese\n- [x] Supports `Artifacts`, `SVG`, `HTML` rendering, js error capture, and opening the Chrome console\n- [x] Agent display optimization, supports searching and drag-and-drop sorting\n- [x] Supports `KaTeX`, displays mathematical formulas, code rendering adding highlighting and quick copy\n- [x] `WebDAV` synchronization\n- [x] Adds `RAG`, based on the MCP knowledge base\n- [x] Introduces the ChatSpace concept, supports multi-dialogue chatting simultaneously\n- [x] Supports Agent Call Agent through HyperAgent's MCP\n- [x] Adds scheduled tasks, specifying Agent to complete tasks on time, and view task completion status.\n\n### TODO:\n\n- [ ] Future versions will include a docker version, integrated Linux desktop, built-in Chrome configuration for remote ports, unified environment, better usability, and web interface control. Usable on any device, including mobile phones.🤣\n- [ ] Permission pop-up, allow or not\n- [ ] Implement using LLM to write MCP for itself\n\n### LLM\n\n| LLM                | Usability    | Notes                         |\n| ------------------ | ------------ | ----------------------------- |\n| claude             | ⭐⭐⭐⭐⭐       | No explanation                |\n| openai             | ⭐⭐⭐⭐⭐       | Can also perfectly support multi-step function calls (gpt-4o-mini can also) |\n| gemini flash 2.0   | ⭐⭐⭐⭐🌙      | Very usable                   |\n| qwen               | ⭐⭐⭐⭐🌙      | Very usable                   |\n| doubao             | ⭐⭐⭐🌙🌙      | Feels okay to use             |\n| deepseek           | ⭐⭐⭐🌙🌙      | Multi-step function calls may have issues |\n\n## Usage\n\n* 1. Configure APIKEY, make sure your LLM service is compatible with OpenAI style.\n* 2. Ensure your system has `uv + nodejs` installed.\n\n### [uvx \u0026 uv](https://github.com/astral-sh/uv)\n\nInstall using the 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 using the 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 pnpm install\nnpm install\nnpm run dev\n```\n\n## Note\n\n* MacOS encounters a damaged or permission issue, `sudo xattr -d com.apple.quarantine /Applications/HyperChat.app`\n* MacOS `nvm` users manually input PATH `echo $PATH`, the Windows version `nvm` seems to work directly\n\n![image.png](./images/image47.png)\n\n## Telegram\n\n[HyperChat User Communication](https://t.me/dadigua001)\n\n#### Call shell mcp\n![image.png](./images/image55.png)\n\n#### Call terminal mcp, ssh + can execute commands\n![image.png](./images/image62.png)\n\n#### One-click webpage generation and publish to (cloudflare)\n![image.png](./images/image60.png)\n\n#### Call Google search, ask it what the TGA Game of the Year is\n![image.png](./images/image22.png)\n\n#### Organize Zhihu hot searches\n![image.png](./images/image36.png)\n\n#### Helps you open a webpage, analyze results, and write to a file\n![image.png](./images/image13.png)\n\n#### Open Baidu and take screenshots\n![image.png](./images/image61.png)\n\n#### Scheduled task list\n![image.png](./images/image52.png)\n\n#### MCP market (experimental)\n![image.png](./images/image43.png)\n\n#### Install MCP interface from the market (experimental)\n![image.png](./images/image45.png)\n\n#### Install MCP from third parties (supports any MCP)\n![image.png](./images/image44.png)\n\n#### Install MCP interface from third parties\n![image.png](./images/image46.png)\n\n#### MCP list (can be dynamically selected)\n![image.png](./images/image21.png)\n\n#### Render HTML, supports `Artifacts`, `SVG`, `HTML` rendering,\n![image.png](./images/image33.png)\n\n#### Interface 1\n![image.png](./images/image51.png)\n\n#### Interface 2\n![image.png](./images/image34.png)\n\n#### Interface 3, testing model 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 carry out any operations, such as web scraping, using this project, it is not related to the developers of this project.","funding_links":[],"categories":["📚 Projects (1974 total)","TypeScript","MCP Clients","AI Integration Mcp Servers","Productivity (8)"],"sub_categories":["MCP Clients","🧪 Development \u0026 Testing Tools","Desktop \u0026 Mobile Clients"],"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"}