# JiwuChat

**Repository Path**: muchenpro/JiwuChat

## Basic Information

- **Project Name**: JiwuChat
- **Description**: JiwuChat 是一款基于 Tauri2 和 Nuxt3 构建的轻量(~8MB)多平台即时通讯聊天应用，具备多种实时消息、AI群聊机器人🤖（DeepSeek、讯飞星火、KimiAI已接入）、WebRTC 音视频通话、屏幕共享以及 AI 购物功能。它支持无缝跨设备通信，涵盖文本、图片、文件和语音等多种消息，还支持群聊和可定制化设置，提供浅/深色模式，助力高效社交网络。✨
- **Primary Language**: TypeScript
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://jiwuchat.kiwi233.top/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 70
- **Created**: 2025-04-09
- **Last Updated**: 2025-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align=center>
 <div align=center margin="10em" style="margin:4em 0 0 0;font-size: 30px;letter-spacing:0.3em;">
<img src="./.doc/jiwuchat-tauri.png" width="140px" height="140px" alt="Image Name" align=center />
 </div>
 <h2 align=center style="margin: 2em 0;">JiwuChat Tauri APP</h2>

<div>
      <a href="https://github.com/Kiwi233333/jiwu-mall-chat-tauri" target="_blank">
        <img class="disabled-img-view"
        alt="GitHub" src="https://img.shields.io/badge/Github-Project-blueviolet.svg?style=plasticr">
      </a>
      <a href="https://github.com/Kiwi233333/jiwu-mall-chat-tauri/stargazers" target="_blank">
        <img class="disabled-img-view" alt="License"
          src="https://img.shields.io/github/stars/Kiwi233333/jiwu-mall-chat-tauri.svg?style=social">
      </a>
    </div>
    <div>
      <a href="https://github.com/Kiwi233333/jiwu-mall-chat-tauri/commits" target="_blank">
        <img class="disabled-img-view" alt="Commit"
          src="https://img.shields.io/github/commit-activity/m/Kiwi233333/jiwu-mall-chat-tauri">
      </a>
      <a href="https://github.com/Kiwi233333/jiwu-mall-chat-tauri/issues" target="_blank">
        <img class="disabled-img-view" alt="Issues" src="https://img.shields.io/github/issues/Kiwi233333/jiwu-mall-chat-tauri">
      </a>
    </div>
    <div>
      <a href="`https://github.com/Kiwi233333/jiwu-mall-chat-tauri/blob/main/LICENSE`" target="_blank">
          <img class="disabled-img-view" alt="License"
          src="https://img.shields.io/github/license/Kiwi233333/jiwu-mall-chat-tauri">
      </a>
      <a href="https://app.netlify.com/sites/jiwuchat/deploys" target="_blank">
          <img src="https://api.netlify.com/api/v1/badges/b68ad9ac-53e5-4c5a-ac56-a8882ffe7697/deploy-status" alt="+QQ Group"/>
      </a>
    </div>

Home Page: [JiwuChat](https://jiwuchat.kiwi233.top/)
<br>
Language : [简体中文](./README.en.md) | English

</div>

## Introduction

JiwuChat is a lightweight `(~10MB)` multi-platform chat application built with Tauri2 and Nuxt3. It features real-time messaging, AI group chat bots (`iFlytek Spark`, `KimiAI`, etc.), `WebRTC audio/video calls`, screen sharing, and AI shopping capabilities. It supports seamless cross-device communication, covering text, images, files, and voice messages, as well as group chats and customizable settings. It offers light/dark modes to enhance efficient social networking. ✨

## One Codebase, Multiple Platforms

![Multi-platform Adaptation](.doc/previews.png)

## Default Account

- Username: ikun233
- Password: 123456
- Experience: [Web Version](https://chat.jiwu.kiwi233.top/)

> ⚠ Note: This account does not have permissions to upload files, modify personal information, change passwords, etc. It is only for testing purposes.

## Feature List

| Module | Description | Status |
| --- | --- | --- |
| User Module | Supports login and registration via username, phone number, and email | ✔ |
| Message Module | Supports real-time chat with text, images, files, voice, @mentions, message recall, and deletion | ✔ |
| Conversation Module | Supports group chats, private chats, and roles like group owner, admin, and regular user | ✔ |
| Contacts Module | Supports viewing, adding, and deleting contacts | ✔ |
| System Version Module | Supports automatic app updates, version announcements, etc. | ✔ |
| Account & Security Module | Provides account login, password change, account management, device security, and online/offline status | ✔ |
| AI Module | Supports multiple AI chat bots in group chats, such as `DeepSeek`, `iFlytek Spark` and `KimiAI` | ✔ |
| Smart Customer Service Module | AI shopping chat functionality, providing product recommendations from `JiwuMall` | ✔ |
| File Download Management Module | Supports local file download, opening, and deletion | ✔ |
| Audio/Video Module | WebRTC-based screen sharing, voice, and video chat | ✔ |
| Other Features | Global dark mode, fonts, custom download paths, multi-system support, and customizable settings | ✔ |

## Project Screenshots

- Chat Desktop App Login / Register

![Login](./.doc/login.png)

![Register](./.doc/register.png)

- Light / Dark Themes

![Light Theme](./.doc/chat1.png)

![Homepage](./.doc/chat.png)

- AI Chatbot (DeepSeek, iFlytek Spark, Kimi AI) 🤩

![AI Chatbot](./.doc/group-ai-ds.png)

![AI Chatbot](./.doc/group-ai-2.png)

![AI Chatbot](./.doc/group-ai-1.png)

- Audio/Video Chat (WebRTC)

![Audio/Video Chat](./.doc/rtc1.png)

- Screen Sharing

![Screen Sharing](./.doc/rtc3.png)

- Chat Social

![Dark Theme](./.doc/chat2.png)

- AI Shopping Chat (Source: [JiwuMall](https://github.com/KiWi233333/jiwu-mall-sites))

![Dark Theme](./.doc/chat3.png)

![Dark Theme](./.doc/chat3.2.png)

- Account & Security

![Account & Security](./.doc/chat4.png)

![Account & Security](./.doc/chat5.png)

- Mobile Adaptation

<div>
 <img src="./.doc/chat12.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat14.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat13.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat7.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/rtc2.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/rtc_remove_desktop.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat8.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat10.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat15.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat11.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat17.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat16.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
 <img src="./.doc/chat9.png" width = "190" style="display:inline-block;" alt="Mobile Adaptation" align=center />
</div>

## ⏳ Getting Started

### 📦 Install Dependencies

```sh
# node version >= 18
npm install -g pnpm

pnpm install
```

### ✨ Development

- 📌 If you do `not` have a backend service, modify the `.env.development` environment variables or use the `.env.production` configuration file.

```sh
# Terminal 1: Start Nuxt (Production Environment)
pnpm run prod:nuxt
# Terminal 2: Start Tauri
pnpm run dev:tauri
```

- If you `have` a backend service, you can modify the `.env.development` environment variables for development.

```sh
# Recommended to run separately
# Terminal 1: Start Nuxt
pnpm run dev:nuxt
# Terminal 2: Start Tauri
pnpm run dev:tauri
```

### 📦 Build

```sh
pnpm run build:tauri
```

### ❌ pnpm install error

Check the registry

```sh
pnpm get registry
```

Temporary change

```sh
pnpm --registry https://registry.npm.taobao.org install any-touch
```

Persistent change

```sh
pnpm config set registry https://registry.npm.taobao.org
```

Revert

```sh
pnpm config set registry https://registry.npmjs.org
```

## 🔧 Tech Stack | Tech Stack

| Category         | Technology/Component          | Version       |
| ------------- | ------------------ | ------------ |
| Framework         | Nuxt             | ^3.14.159+       |
|                 | Tauri               | ^2.1.0        |
| UI Library     | Element Plus       | ^2.8.4        |
| State Management     | Pinia              | 2.1.7        |
| Utility Library       | Vueuse             | 10.11.0      |
| Build & Development Tools | Nuxi               | lts        |
|              | Vite               | lts         |
| Code Quality     | ESLint             | 8.56.0       |
|              | Prettier           | 3.3.2        |
| Type Checking     | TypeScript         | 5.3.2        |
| Styling     | Sass               | 1.77.6       |

## 🦾  Trends

![JiwuChat Star History Chart](https://api.star-history.com/svg?repos=KiWi233333/jiwu-mall-chat-tauri&type=Date)

## 💬 Contact

- Email: [kiwi2333@qq.com](mailto:kiwi2333@qq.com)