Repolode
GaiZhenbiao

GaiZhenbiao/ChuanhuChatGPT

A lightweight web GUI for ChatGPT and many other LLMs, with file-based Q&A, web search, local model deployment and an agent assistant.

Open-source alternative to:ChatGPT

Stars
15,243
Forks
2,178
Open issues
131
Last commit
2 months ago

What is it?

Chuanhu Chat is a Python web interface built on Gradio that lets you chat with ChatGPT and a wide range of other large language models from one place. It covers hosted APIs such as OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, iFlytek Spark, MiniMax and Midjourney, as well as locally deployed models such as ChatGLM, LLaMA, StableLM, MOSS and Qwen.

Beyond basic chat, it adds a knowledge base that answers questions from uploaded files, online search to bring in current information, and an agent-style assistant that works through multi-step tasks. Conversation history is saved automatically, can be searched with regular expressions and renamed, and is isolated per user. It also supports GPT-3.5 fine-tuning, system prompt templates, LaTeX and code rendering, and installation as a PWA on desktop and mobile.

The project is set up by cloning the repository, installing requirements, and copying the example config file to config.json to add API keys. It can be deployed to a server, shared through a public link, or run on Hugging Face Spaces.

Key features

  • 01Chat with ChatGPT, Claude, Gemini, DeepSeek and many other hosted LLM APIs in one interface.
  • 02Run local models such as ChatGLM, LLaMA, Qwen and MOSS.
  • 03Answer questions from uploaded files through a knowledge base.
  • 04Search the web to supply LLMs with up-to-date information.
  • 05Save, search, rename and isolate conversation history per user.
  • 06Install as a PWA on desktop and mobile.

Use cases

  • Using one chat front end to compare or switch between several LLM providers.
  • Asking questions over your own documents without building a RAG pipeline.
  • Hosting a shared chat interface for a small team with separate histories.
  • Running a local open-source model behind a familiar chat UI.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/GaiZhenbiao/ChuanhuChatGPT.git
  2. 2

    Enter the project folder and install dependencies

    cd ChuanhuChatGPT pip install -r requirements.txt
  3. 3

    Copy config_example.json to config.json and fill in your API key

  4. 4

    Start the app; a browser window opens automatically

    python ChuanhuChatbot.py

Things to know

  • Using commercial model APIs such as ChatGPT requires your own API key.
  • Licensed under GPL-3.0, which requires derivative works to remain open source under the same license.

In collections

Topics

FAQ

What is ChuanhuChatGPT?
A lightweight web GUI for ChatGPT and many other LLMs, with file-based Q&A, web search, local model deployment and an agent assistant. Chuanhu Chat is a Python web interface built on Gradio that lets you chat with ChatGPT and a wide range of other large language models from one place. It covers hosted APIs such as OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, iFlytek Spark, MiniMax and Midjourney, as well as locally deployed models such as ChatGLM, LLaMA, StableLM, MOSS and Qwen.
Is ChuanhuChatGPT free to use? What license does it have?
ChuanhuChatGPT is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is ChuanhuChatGPT still maintained?
Updated within 6 months. The last commit to ChuanhuChatGPT was on Sep 16, 2026.
What can I use ChuanhuChatGPT for?
Using one chat front end to compare or switch between several LLM providers. Asking questions over your own documents without building a RAG pipeline. Hosting a shared chat interface for a small team with separate histories. Running a local open-source model behind a familiar chat UI.
How do I install ChuanhuChatGPT?
Clone the repository: git clone https://github.com/GaiZhenbiao/ChuanhuChatGPT.git Enter the project folder and install dependencies: cd ChuanhuChatGPT pip install -r requirements.txt Copy config_example.json to config.json and fill in your API key Start the app; a browser window opens automatically: python ChuanhuChatbot.py
Where can I get ChuanhuChatGPT?
The source code and installation instructions are on GitHub: https://github.com/GaiZhenbiao/ChuanhuChatGPT

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects