Robby-聊天机器人 🤖

一款具备对话记忆功能的AI聊天机器人，旨在让用户以更直观的方式讨论其CSV、PDF、TXT数据以及YouTube视频。🚀

我目前正致力于让AI在地理空间领域发挥作用——与我的父亲和挚友共同构建TerraLab，欢迎来看看哦嘿嘿

Robby机器人出自电影《禁忌星球》

为了更好地理解，可参阅我的Medium文章 🖖 ：基于你的CSV数据构建聊天机器人

功能 ✨

• Robby-聊天：使用向量嵌入和对话记忆与您的文档（PDF、TXT、CSV）进行对话
• Robby-表格：借助PandasAI，用自然语言分析表格数据
• Robby-Youtube：利用AI总结YouTube视频

技术栈 🛠️

• LangChain - LLM编排框架
• OpenAI - GPT-4o、GPT-4o-mini、GPT-4-turbo、GPT-3.5-turbo
• PandasAI - 自然语言数据分析
• Streamlit - Web应用框架
• FAISS - 向量相似度搜索

本地运行 💻

请按照以下步骤在本地设置并运行服务：

前置条件

• Python 3.10或更高版本
• Git
• OpenAI API密钥

安装

克隆仓库：

git clone https://github.com/yvann-hub/Robby-chatbot.git

进入项目目录：

cd Robby-chatbot

创建虚拟环境：

python -m venv .venv
source .venv/bin/activate  # macOS/Linux
# 或
.venv\Scripts\activate  # Windows

安装所需依赖：

pip install -r requirements.txt

在本地启动聊天服务：

streamlit run src/Home.py

环境变量（可选）

您也可以将OpenAI API密钥设置为环境变量，而非在UI中输入：

export OPENAI_API_KEY="your-api-key-here"

或者在项目根目录下创建一个.env文件：

OPENAI_API_KEY=your-api-key-here

就这样！服务现已在本地启动并运行。🤗

可用模型 🤖

• GPT-4o-mini - 速度快、成本低（默认）
• GPT-4o - 功能最强大的模型
• GPT-4-turbo - 性能均衡
• GPT-3.5-turbo - 传统模型

贡献 🙌

如果您想为本项目贡献力量，请提交问题、拉取请求，或联系我：barbot.yvann@gmail.com (:

Robby-chatbot 快速上手指南

Robby-chatbot 是一款支持对话记忆的 AI 聊天机器人，旨在让用户以更直观的方式与 CSV、PDF、TXT 文档及 YouTube 视频进行交互。本项目基于 LangChain、OpenAI 和 Streamlit 构建。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• Python 版本：3.10 或更高版本
• 必要工具：Git
• API 密钥：有效的 OpenAI API Key

安装步骤

1. 克隆项目

打开终端，将代码仓库克隆到本地：

git clone https://github.com/yvann-hub/Robby-chatbot.git

进入项目目录：

cd Robby-chatbot

2. 创建虚拟环境

为避免依赖冲突，建议创建独立的虚拟环境：

python -m venv .venv

激活虚拟环境：

• macOS/Linux:

  source .venv/bin/activate
  

• Windows:

  .venv\Scripts\activate
  

3. 安装依赖

安装项目所需的 Python 包（国内用户如遇下载缓慢，可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 参数）：

pip install -r requirements.txt

4. 配置 API 密钥（可选）

您可以选择将 OpenAI API Key 设置为环境变量，以免每次启动时手动输入。

• 临时设置（当前终端会话有效）:

  export OPENAI_API_KEY="your-api-key-here"
  

  (Windows PowerShell 用户使用 $env:OPENAI_API_KEY="your-api-key-here")

• 永久设置（推荐）: 在项目根目录创建 .env 文件，并写入以下内容：

  OPENAI_API_KEY=your-api-key-here
  

基本使用

完成上述步骤后，即可启动服务。

启动应用

在终端运行以下命令启动 Streamlit 界面：

streamlit run src/Home.py

浏览器将自动打开应用页面（通常地址为 http://localhost:8501）。

功能体验

在 Web 界面中，您可以直接使用以下核心功能：

1. Robby-Chat：上传 PDF、TXT 或 CSV 文件，利用向量嵌入和对话记忆与文档内容进行自然语言问答。
2. Robby-Sheet：上传表格数据，使用 PandasAI 通过自然语言指令进行数据分析。
3. Robby-Youtube：输入 YouTube 视频链接，让 AI 自动生成视频摘要。
4. 模型切换：在侧边栏可选择不同的 OpenAI 模型（默认使用速度快且成本低的 GPT-4o-mini，也可切换至 GPT-4o 等）。