# llm2ros

**Repository Path**: scujcc-robot/llm2ros

## Basic Information

- **Project Name**: llm2ros
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-06-19
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# llm2ros

## 介绍

llm2ros是成都哟罗机器人有限公司推出的基于大语言模型的机器人智能体平台，同时支持开源模型与OpenAI模型接口。专为ROS（机器人操作系统）开发者设计，提供稳定、高效、安全的通用大模型调用解决方案。

**核心功能：**
- 支持多种大语言模型接入（ChatGPT、开源模型）
- 文本向量化与向量数据库存储
- 基于语义相似度的智能问答系统
- Web界面交互支持
- ROS机器人系统深度集成

**应用场景：**
- 机器人智能对话与导航
- 企业级智能问答系统
- 文档知识库智能检索
- ROS机器人语音助手开发

## 软件架构

```
llm2ros/
├── agentwebui.py    # Web界面智能体
├── chatgpt.py       # OpenAI模型接口
├── database.py      # 向量数据库管理
├── qa.py           # 问答系统模块
├── web.py          # Web服务框架
├── test.txt        # 测试文档
├── data.csv        # 数据存储
└── prompt.txt      # 提示词模板
```

**技术栈：**
- ROS（机器人操作系统）
- Python 3.10+
- LangChain框架
- OpenAI API
- 向量数据库
- Flask/FastAPI（Web服务）

## 安装教程

### 环境要求
- Python 3.10+
- ROS（根据实际版本安装）
- Git

### 安装步骤

```bash
# 1. 克隆项目
git clone https://gitee.com/scujcc-robot/llm2ros.git

# 2. 进入项目目录
cd llm2ros

# 3. 安装依赖
pip install langchain
pip install openai
pip install langchain-community  # 扩展功能

# 4. 安装其他可能需要的依赖
pip install flask transformers sentence-transformers
```

## 使用说明

### 1. 准备知识库文档

编辑 `test.txt` 文件，添加需要机器人学习的知识内容：

```
# 示例内容
机器人导航命令：
- "去厨房" - 导航到厨房位置
- "回充电桩" - 返回充电位置
- "巡检模式" - 开始自动巡检

安全规则：
- 检测到障碍物时自动停止
- 电池低于20%时自动返回充电
```

### 2. 构建向量数据库

```bash
python database.py
```

此命令将：
- 读取 `test.txt` 文档内容
- 将文本分段并向量化
- 存储到向量数据库中永久保存

### 3. 启动智能问答系统

```bash
# 启动Web服务
python web.py

# 或启动智能体Web界面
python agentwebui.py
```

### 4. API调用示例

```python
# chatgpt.py 使用示例
from chatgpt import get_chat_response

prompt = "请分析机器人当前状态"
response = get_chat_response(prompt)
print(response)
```

```python
# qa.py 使用示例
from qa import navigation

result = navigation("带我去厨房")
print(result)
```

## 功能模块

### 智能问答（qa.py）
基于提示词模板和语义理解，提供精准的问答服务，支持机器人导航指令识别。

### 向量检索（database.py）
- 文本分块处理
- 语义向量化存储
- 余弦相似度计算
- 知识库持久化存储

### 多模型支持（chatgpt.py）
- OpenAI GPT模型接口
- 开源模型适配器
- 统一的调用接口

### Web交互（web.py / agentwebui.py）
- 实时对话界面
- 产品推荐功能
- FAQ智能回复
- 机器人控制接口

## 贡献指南

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 发起 Pull Request

## 许可证

本项目遵循开源协议，具体许可证信息请查看 LICENSE 文件。

## 联系方式

- **企业官网**: [https://yourorobot.com](https://yourorobot.com)
- **项目地址**: [https://gitee.com/scujcc-robot/llm2ros](https://gitee.com/scujcc-robot/llm2ros)

---

如有任何问题或建议，欢迎通过Gitee平台提交Issue，我们会及时处理。