# agent-xiaoxue

**Repository Path**: Foundpeter/agent-xiaoxue

## Basic Information

- **Project Name**: agent-xiaoxue
- **Description**: openKylin-AI agent赛道项目作品
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-06
- **Last Updated**: 2025-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 智能体 小雪
可执行文件、完整源代码、项目演示视频、答辩PPT链接为：https://pan.baidu.com/s/1UYIcrvYEuIec2IZ1lhRfQA?pwd=ok10
### 安装指南
按照下列步骤进行：确保您安装了openKlin1.0 x86并且下载源文件到桌面
1.打开终端安装下列第三方库和系统软件包。
```bash
sudo apt update
sudo apt full-upgrade
sudo apt install curl
sudo apt install python3-pip 
pip install testresources
pip install --upgrade pip setuptools wheel Pillow pip -i https://mirrors.aliyun.com/pypi/simple
sudo apt-get install build-essential
sudo apt install software-properties-common
sudo apt install python3.10
sudo apt-get install python3-tk python3-dev
sudo apt install scrot
sudo apt-get install espeak-ng
sudo apt-get install portaudio19-dev
```
2.打开源代码目录终端安装依赖：
```bash
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple
```
3.安装python3.10下的依赖项（这一步主要是PDF文档提取工具的环境搭建）在终端输入：
```bash
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3.10 get-pip.py
python3.10 -m pip install detectron2 --extra-index-url https://wheels.myhloli.com -i https://mirrors.aliyun.com/pypi/simple/
python3.10 -m pip install -U magic-pdf[full] --extra-index-url https://wheels.myhloli.com -i https://mirrors.aliyun.com/pypi/simple/
python3.10 -m pip install --force-reinstall psutil
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo os=ubuntu dist=focal bash
sudo apt-get install git-lfs
git lfs install
#将源代码中的minerUdemo文件夹移至桌面，然后打开终端下载模型到此处。
git lfs clone https://www.modelscope.cn/opendatalab/PDF-Extract-Kit.git
```
tips:下载完模型权重文件之后应该会在用户主目录“/home/{用户名}”下创建一个magic-pdf.json文件，请检查是否生成。
如未成功生成可根据[参考项目](https://github.com/opendatalab/MinerU/blob/master/docs/how_to_download_models_zh_cn.md "点击查看参考项目")更换下载方式。

4.在vscode中打开源代码目录，选择解释器select interpreter：python3.8.2
点击运行main.py
### 1. 使用说明
可执行文件。需要前往 https://www.zhipuai.cn/ 申请一个智谱AI的大模型API密钥，该网址也可自己组建一个线上知识库申请知识库ID作为智能体的能力拓展，
此外发送邮件需要邮箱授权码，它是实现自动发送邮件的核心。
下载完可执行文件后 ，假设你的文件路径是 ~/桌面/可执行文件/dist/main，你可以按照以下步骤在终端中运行它，在终端执行：
```bash
cd ~/桌面/可执行文件/dist
# 确保文件具有执行权限
chmod +x main
# 运行文件，也可以点击直接运行
./main
```
首次使用时，需要在界面点击配置按钮填写包括API密钥在内的参数信息。
### 2. 问题解决
 如遇到问题时，1.查询代码目录中的项目功能说明书，或者观看项目演示视频。
                          2.及时清理对话框的内容或调整模型温度。
                          2. 尝试重启程序。
                          3.对源代码进行测试。
                          4.联系作者，邮箱：fmy144755@163.com
### 3.特殊说明
1.部分机型（特别是虚拟机）在设置腾讯会议“接收桌面右下角通知”选项开启时，仍然无法显示通知，这影响了纪要发送环节。
2.在源代码测试中各项功能都能测试成功，但是打包可执行文件后发起会议功能存在浏览器闪退现象，在积极查明原因中。
3.生成PPT功能用时约3分钟左右，22页内容。
4.PDF读取功能会耗费较多的硬件资源
### 4. 参考项目
语音识别模型新一代kaldi：https://k2-fsa.github.io/sherpa/onnx/index.html 

PDF提取项目minerU：https://github.com/opendatalab/MinerU  
### 许可证

此项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE.txt 文件。
### 法律声明

有关版权和许可证信息，请参阅项目根目录中的 NOTICE.txt文件。