# GradioDeepseekApp

**Repository Path**: annomono/GradioDeepseekApp

## Basic Information

- **Project Name**: GradioDeepseekApp
- **Description**: 一个简单的聊天机器人网页应用程序，使用 DeepSeek 的 API 来响应文本输入。通过 Gradio 库启动，允许用户通过友好的界面提交文本，并接收聊天机器人的响应。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-12-06
- **Last Updated**: 2025-08-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 描述

这个应用程序是一个聊天机器人网页界面，使用 DeepSeek 的 API 来响应文本输入。它通过 Gradio 库启动，允许用户通过友好的界面提交文本，并接收聊天机器人的响应。

# 安装依赖

在应用目录下打开命令行并运行以下命令：

```bash
pip install -r requirements.txt
```

# API 密钥

该应用程序需要一个 API 密钥才能正常工作。
请创建一个 `.env` 文件，并在其中写入你的 deepseek API 密钥：

```bash
API_KEY=XXXXXXXXX
```

# 首次启动

在应用目录下打开命令行并运行：

```bash
python myStreamBot.py
```

然后在浏览器中打开 `http://127.0.0.1:8080/` 即可看到运行结果。

首次启动时，程序会自动在根目录创建所需的文件和文件夹，如 `histories`、`settings`、`few-shots` 等。

# 自定义选项

## 添加 Few-shot 示例

Few-shot 学习是指在请求中提供一些示例，让模型学习到特定的模式。你可以通过自定义的 few-shot 示例来提供对话的前后文。

在 `few-shots` 文件夹下新建一个自定义的 JSON 文件，例如：

```json
[  
    {"role": "system", "content": "你是一位历史学专家，用户将提供一系列问题，你的回答应当简明扼要，并以`Answer:`开头"},
    {"role": "user", "content": "请问秦始皇统一六国是在哪一年？"},
    {"role": "assistant", "content": "Answer:公元前221年"},
    {"role": "user", "content": "请问汉朝的建立者是谁？"},
    {"role": "assistant", "content": "Answer:刘邦"},
    {"role": "user", "content": "请问唐朝最后一任皇帝是谁"},
    {"role": "assistant", "content": "Answer:李柷"},
    {"role": "user", "content": "请问明朝的开国皇帝是谁？"}
]
```

或者

```json
[
    {"role": "system", "content": "你是一个软件开发工作者。我将提供一些关于网络应用需求的具体信息，而你的工作是提出一个架构和代码，用 Golang 和 Angular 开发安全的应用。"}
]
```

## 配置设置

在 `settings` 文件夹下新建一个自定义的 JSON 配置文件，格式形如：

所有属性都是可选项, 在 `settings`中配置以取代默认值

```json
{
    "last-history": "{对话历史文件名称，在每次对话时自动生成，不需要手动设置}",
    "few-shot": "{fewshot文件名称，用于加载设定的场景}",
    "name": "{名称}",
    "temperature": 0~2, //采样温度，更高的值，如 0.8，会使输出更随机，而更低的值，如 0.2，会使其更加集中和确定
    "frequency_penalty": -2.0 ~ 2.0 //如果该值为正，那么新 token 会根据其是否已在已有文本中出现受到相应的惩罚，从而增加模型谈论新主题的可能性
}
```

例如：

```json
{
    "last-history": "history_ChatBot_20241206142053.json",
    "few-shot": "new-bot.json",
    "name": "A-BOT",
    "temperature": 1.5,
    "frequency_penalty": 1.2
}
```

## 可选参数

在命令行运行时可以添加参数来修改端口号、加载的配置文件名以及是否共享到公网：

```bash
python myBot.py --port={端口号，默认为8080} --setting={配置文件名称（不包括后缀），对应的json配置文件应位于settings文件夹下，默认为setting} --share={True|False，是否分享到公网，默认为False}
```

例如：

```bash
python myBot.py --port=8888 --setting=newbot --share=True
```

运行后，你可以在 `http://127.0.0.1:8888/` 网址以及命令行给出的公网地址上访问你的应用程序。