# PureChat

**Repository Path**: udx/PureChat

## Basic Information

- **Project Name**: PureChat
- **Description**: PureChat 是一款基于 Vue3 + ElementPlus，结合 AI 和前沿技术的聊天应用，内置OpenAI，Ollama，DeepSeek等大语言模型，支持 Markdown 渲染，聊天记录生成截图，主题切换，助力开发者快速掌握现代技术。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://purechat.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 136
- **Created**: 2025-03-24
- **Last Updated**: 2025-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a>
    <img src="./images/log.png" alt="logo" width="128" height="128">
  </a>
  <h2 align="center" style="font-weight: 600;font: bold 200% Consolas, Monaco, monospace;color: #999;" >
    PureChat
  </h2>
  <p align="center">
    <span>聊天应用与AI开发框架</span>
    <br />
    <a href="https://purechat.cn" target="blank">
      <strong>🌎 在线预览</strong>
    </a>
    &nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://jq.qq.com/?_wv=1027&k=Cd4Ihd2J" target="blank">
      <strong>💬 联系作者</strong>
    </a>
    <br />
    <br />
  </p>
</p>

[![Web][Web-image]][web-url]
[![Windows][Windows-image]][download-url]
[![MacOS][MacOS-image]][download-url]

<!-- SHIELD GROUP -->

[![GitHub license](https://img.shields.io/github/license/Hyk260/PureChat)](https://github.com/Hyk260/PureChat/blob/master/LICENSE)
[![Stars](https://img.shields.io/github/stars/Hyk260/PureChat.svg)](https://github.com/Hyk260/PureChat/stargazers)
[![Forks](https://img.shields.io/github/forks/Hyk260/PureChat.svg)](https://github.com/Hyk260/PureChat/network/members)

## 简介

[反馈](https://github.com/Hyk260/PureChat/issues) /
[QQ 群](https://github.com/Hyk260/PureChat/discussions/2) /
[打赏开发者](./images/weix.png) /
[文档](https://docs.purechat.cn) /
[更新日志](https://docs.purechat.cn/other/logs.html)

### 🎉 特性

- 📦️ 基于 Vue3，Vite5构建高效应用
- 📸 聊天记录支持生成截图并支持一键复制
- 💡 会话基于 腾讯IM即时通讯SDK
- 🌙 根据系统主题自动切换光明与黑暗模式
- 📝 支持 Markdown渲染，代码高亮，链接识别
- 🛡️ GitHub 快速登录，享受无缝社交体验
- ☁️ 多模型支持 OpenAI、Ollama、DeepSeek 等，支持流式输出 自定义预设提示词
- ✨ 提供桌面应用 Electron 版本，支持 macOS (.dmg) 与 Windows (.exe)
- 🛠 更多特性持续开发中

### 环境配置

本地环境需要安装 Node.js 18.20+

### 克隆代码

```bash
git clone https://github.com/Hyk260/PureChat.git
```

### 安装依赖

```bash
pnpm install
```

### 启动项目

```bash
# For web
pnpm dev

# For windows or macOS
pnpm app:dev
```

### 打包

```bash
# For web
pnpm build

# For windows
pnpm app:builder:win

# For macOS
pnpm app:builder:mac
```

### Star History
<!-- https://star-history.com/ -->
![Star History](./images/star-history.png)

### 🖼️ 截图

<img src="./images/chat.png">

<img src="./images/discover.png">

<img src="./images/config.png">

<img src="./images/screenshot.png">

### 环境变量

本项目提供了一些额外的配置项，使用环境变量进行设置：

| 环境变量                | 类型 |                             描述                             |                             示例                             |
| :---------------------- | :--: | :----------------------------------------------------------: | :----------------------------------------------------------: |
| `VITE_OPENAI_API_KEY`   | 必选 |                       OpenAI API 密钥                        |                     `sk-xxxxxx...xxxxxx`                     |
| `VITE_OPENAI_PROXY_URL` | 可选 |   OpenAI 接口代理，此配置可以覆盖默认 OpenAI API 基础 URL    | `https://aihubmix.com/v1`<br/>默认值:<br/>`https://api.openai.com/v1` |
| `VITE_IM_SDK_APPID`     | 必选 |     腾讯IM SDKAppID https://cloud.tencent.com/product/im     |                           `xxxxxx`                           |
| `VITE_SERVICE_BASE_URL` | 必选 |                          服务器地址                          |                   `https://your.api.com/`                    |
| `VITE_LOCAL_MODE`       | 可选 | 开启本地模式不使用腾讯IM SDK ，为`Y` 时 可不填im sdk，使用本地indexedDB保存数据，开启后不支持多端消息同步，做为本地ai问答工具使用。 |                             `Y`                              |

<!-- LINK GROUP -->

[web-url]: https://purechat.cn
[download-url]: https://github.com/Hyk260/PureChat/releases
[Web-image]: https://img.shields.io/badge/Web-orange?logo=microsoftedge
[Windows-image]: https://img.shields.io/badge/-Windows-blue?logo=windows
[MacOS-image]: https://img.shields.io/badge/-MacOS-black?logo=apple