# vector-knowledge-base

**Repository Path**: weedlu/vector-knowledge-base

## Basic Information

- **Project Name**: vector-knowledge-base
- **Description**: 向量检索知识库。向量存放docx/pdf/md/txt文档，结合LLM实现文档增强检索利用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI向量知识库

向量检索知识库。向量存放docx/pdf/md/txt文档，结合LLM实现文档增强检索利用。

## 功能特性

- 简单鉴权（admin/admin）
- 文档管理（上传、查看、删除）
- 配置管理（全局参数配置）
- 智能问答（向量检索 + LLM）

## 技术栈

- **后端**：Python
- **前端**：Vue 3 + Element Plus + Vite
- **向量库**：Chroma + bge-base-zh-v1.5
- **大模型**：MiniMax API

## 快速开始

### 1. 克隆项目

```
git clone https://gitee.com/weedlu/vector-knowledge-base.git
cd vector-knowledge-base
```
### 2. 开发环境
IntelliJ IDEA + Lingma

### 3. 后端部署

```
# 1）安装chroma
# 创建虚拟环境
python -m venv .venv
# 激活虚拟环境
.venv\Scripts\activate
# 安装 chromadb
pip install chromadb

# 2）下载 bge-base-zh-v1.5
wget https://modelscope.cn/models/BAAI/bge-base-zh-v1.5

# 3)配置 MiniMax API Key
# 编辑 backend/config.yml

# 4)安装工程依赖
pip install -r requirements.txt

# 5)编译运行
python main.py
```
后端端口[main.py]：8000
```
if __name__ == "__main__":
    uvicorn.run(
        "main:app",
        host="0.0.0.0",
        port=8000,
        reload=False
    )
```


### 4. 前端部署

```
cd frontend
npm install
npm run dev
```

前端端口[vite.config.js]：5173
```
  server: {
    port: 5173,
    proxy: {
      '/api': {
        target: 'http://localhost:8000',
        changeOrigin: true,
        rewrite: (path) => path
      }
    }
  },
```

### 5. 访问系统

浏览器打开：http://localhost:5173

默认账号：admin / admin

## 配置说明

### application.yml

```yaml
# 向量库配置
collection_name: knowledge_base
embedding_model: BAAI/bge-base-zh-v1.5
similarity_threshold: 0.5

# MiniMax API 配置
max_tokens: 2000
minimax_api_key: your-api-key-here
minimax_model: MiniMax-M2.7
minimax_url: https://api.minimax.chat/v1/chat/completions
```
## 存储目录结构
```
backedn/db/chroma_db
backedn/db/models
backedn/db/uploads
backedn/db/knowledge_base.db
```

## 使用说明

1. **登录**：使用 admin/admin 登录
2. **文档管理**：支持 PDF、Word、TXT 格式
3. **配置管理**：配置向量库以及 MiniMax 相关参数
4. **AI对话**：LLM + 向量检索回答问题，打字机式

## License

MIT