# chat_widget_dj

**Repository Path**: windy5/chat_widget_dj

## Basic Information

- **Project Name**: chat_widget_dj
- **Description**: 专注于企业嵌入AI小组件开发的Django应用，提供易于集成的对话界面，适用于网页和移动设备，助力企业嵌入AI快速实现互动交流功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-02-26
- **Last Updated**: 2025-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chat Widget DJ 企业AI助手项目介绍

## 一、项目概述

>`chat_widget_dj` 是一款专为企业快速接入AI大模型的解决方案设计的应用程序，旨在提供最便捷的方式为本地部署Deepseek的企业快速接入企业应用的AI助手集成方案。

通过该应用，企业可以快速将 DeepSeek 或其他通过 Ollama 部署的本地大模型集成到自身管理系统或者企业官网中。无论是网页端还是移动设备，利用该组件都能迅速实现与 DeepSeek 等大模型的互动交流功能。这极大地节省了开发时间，助力企业第一时间实现业务系统与 AI 的对接。

<img src="media/preview.gif" alt="chat_widget_dj示例" style="max-width: 320px; width: 100%;">


### 不想部署直接试用（服务器为家里一台破电脑，随时可能挂掉。建议按照以下方式安装👇）

 **复制`<script>`标签**：将复制的`<script>`代码粘贴到企业需要嵌入的页面中，最后部署企业网站，即可完成整个集成过程。
 

```html
<script data-appkey="ERaulky0JhFjjcIc6IGEN6rILUXF9lxL" status="chat-widget" src="https://nas.5windy.com:8181/media/chat-widget.js"></script>
```

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/chat_preview.gif" alt="chat_widget_dj示例" style="width: 500px;">
</div>


## 二、部署方式

### （一）环境准备

本项目采用 `docker-compose` 方式进行部署。在开始部署前，用户需要先安装 Docker 以及 Docker Compose。安装完成后，即可通过复制特定代码实现快速部署。
安装docker请另行查阅相关资料。

### （二）部署步骤

1. **下载Ollama并安装大模型**：点击[ollama官网连接](https://ollama.com)下载ollama并安装AI大模型，请根据自身电脑配置选择。
<div style="width: 100%;display: flex;justify-content: center">
    <img src="media/preview1.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>

下载链接若需要科学上网，可尝试复制链接，使用`迅雷下载`。

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/preview2.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>

下载完成后，打开`终端`，运行安装大模型。等待安装完成。
```gitexclude
ollama run deepseek-r1:1.5b（自己也可以替换7b\8b\671b）等，按自己服务器配置决定。
```

2. **下载代码**：获取项目的代码文件，为后续配置做准备。
```gitexclude
https://gitee.com/windy5/chat_widget_dj.git
```
3. **环境变量中 放行 Ollama 服务器通信地址**：

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/preview3.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>

```gitexclude
# 变量名
OLLAMA_HOST
# 变量值
0.0.0.0:11434
```

#### **此处需要特别注意**： 添加环境变量后，一定要重启 `ollama` 服务, 否则 docker服务无法与ollama通信。

4. **项目配置ollama服务器地址**：根据实际情况，对 Ollama 服务器地址进行相应修改，确保能正确连接到 Ollama 服务。（docker和ollama都在一台服务器主机上可忽略此步骤）
```python
# ./chat_widget_dj/setting.py 文件最后一行修改Ollama服务器地址，本机地址可不用修改
# 大模型IP及端口
OLLAMA_IP = '127.0.0.1:11434'
```
3. **进入文件夹并运行**：在完成上述步骤后，进入项目的文件夹，并利用 `docker-compose.yml` 文件来启动项目。

```python
# 进入项目文件夹
cd C:\GitHub\chat_widget_dj

# 启动项目
docker-compose up -d
```

若因为网络原因，无法下载镜像文件，可在docker中配置国内镜像：（配置方法liunx与windows有所不同，请自行百度）
```json
    "registry-mirrors": [
        "https://hub.uuuadc.top",
        "https://docker.anyhub.us.kg",
        "https://dockerhub.jobcher.com",
        "https://docker.ckyl.me",
        "https://docker.awsl9527.cn",
        "https://ustc-edu-cn.mirror.aliyuncs.com/",
        "https://ccr.ccs.tencentyun.com/",
        "https://2a6bf1988cb6428c877f723ec7530dbc.mirror.swr.myhuaweicloud.com",
        "https://hub-mirror.c.163.com",
        "https://your_preferred_mirror",
        "https://dockerhub.icu",
        "https://docker.registry.cyou",
        "https://docker-cf.registry.cyou",
        "https://dockercf.jsdelivr.fyi",
        "https://docker.jsdelivr.fyi",
        "https://dockertest.jsdelivr.fyi",
        "https://mirror.aliyuncs.com",
        "https://dockerproxy.com",
        "https://mirror.baidubce.com",
        "https://docker.m.daocloud.io",
        "https://docker.nju.edu.cn",
        "https://docker.mirrors.sjtug.sjtu.edu.cn",
        "https://docker.mirrors.ustc.edu.cn",
        "https://mirror.iscas.ac.cn",
        "https://docker.rainbond.cc"
    ]
```

其他说明： **配置SSL证书**：若项目需要配置`https`，请将对应证书放置`./ssl`文件夹下，并修改`./gunicron_config.py`文件。(本项目默认关闭HTTPS)

```python
# SSL 证书和私钥文件路径，根据实际情况修改
certfile = './ssl/cert.pem'
keyfile = './ssl/privkey.pem'
```

### （三）部署完成

当部署流程结束后，可在浏览器中输入 `http://127.0.0.1:8181/admin`，查看应用是否正常运行。默认用户名是 `5windy`，密码为 `123qwe!@#`。

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/preview4.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>

## 三、使用方式

1. **创建 AppKey 并复制标签代码**：在登录后的界面中，创建 AppKey，复制AppKey下来。

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/preview5.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>

2. **复制`<script>`标签，并替换`data-appkey`**：将复制的`<script>`代码粘贴到企业需要嵌入的页面中，最后部署企业网站，即可完成整个集成过程。
   (局域网或外网部署，请替换SRC的IP域名和端口)

```html
<script data-appkey="ERaulky0JhFjjcIc6IGEN6rILUXF9lxL" status="chat-widget" src="http://127.0.0.1:8181/media/chat-widget.js"> </script>
```

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/chat_preview.gif" alt="chat_widget_dj示例" style="width: 500px;">
</div>

## 四、技术交流，请加QQ群

点击链接加入群聊[chat_widget企业AI助手咨](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=r4UqAUlxMfYQ_ChgNJ2PCbBqHkUSP6pS&authKey=kxXjYVwsGt6btS%2FxtV6W%2BJvcAn8qiL1Ij1SUjbbwRiDnJ9c4ZMy1r2iraj42tuew&noverify=0&group_code=1030209910)

<div style="width: 100%;display: flex;justify-content: center;margin-top: 10px">
    <img src="media/preview6.png" alt="chat_widget_dj示例" style="width: 500px;">
</div>