# xcnvs

**Repository Path**: OsirisBBQ/xcnvs

## Basic Information

- **Project Name**: xcnvs
- **Description**: 开源管理平台（xcnvs）
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 16
- **Created**: 2025-12-05
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## xcnvs
* 作者：北小菜 
* 作者主页：https://www.yuturuishi.com
* gitee开源地址：https://gitee.com/Vanishi/xcnvs
* github开源地址：https://github.com/beixiaocai/xcnvs

### 项目介绍
集群管理平台（简称xcnvs）是一款支持视频文搜，万物搜等功能的AI视频分析工具。也可以用来作为视频行为分析系统v3/v4的集群管理软件。

### 项目架构

#### 核心子项目

##### 1. emb_server
- **功能**：提供文本嵌入服务，基于Sentence-Transformers模型将文本转换为向量表示
- **技术栈**：Flask、Sentence-Transformers、Python
- **端口**：默认1235
- **用途**：为视频文搜等功能提供文本向量转换支持

##### 2. xcnvs_admin
- **功能**：主管理平台，提供完整的Web界面和API服务
- **技术栈**：Django、Python、Bootstrap、jQuery
- **端口**：默认9824
- **模块**：
  - 系统管理：用户管理、节点管理、配置管理
  - 媒体管理：视频流管理、存储管理
  - AI功能：样本管理、标注工具、模型训练、模型管理、模型测试、模型导出
  - 告警管理：告警配置、告警查看
  - 控制管理：设备控制、集群管理

### 核心功能

#### 视频文搜，万物搜
- 基于文本描述搜索视频内容
- 支持自然语言查询
- 高精度视频片段检索


#### 视频行为分析系统v3/v4集群管理
- 节点状态监控
- 任务分布式调度
- 资源管理和分配
- 负载均衡

### 技术栈

| 类别 | 技术 | 版本 |
|------|------|------|
| 后端框架 | Django | 3.x+ |
| 后端框架 | Flask | 3.0.3 |
| 语言 | Python | 3.8+ |
| 前端框架 | Bootstrap | 3.x |
| 前端库 | jQuery | 3.x |
| AI模型 | Sentence-Transformers | 5.1.1 |
| 数据库 | PostgreSQL | - |
| 向量数据库 | PostgreSQL Vector | - |

### 快速开始

#### 环境要求
- Python 3.8+
- Git
- 操作系统：Windows/Linux

#### 安装步骤

##### 1. 克隆项目
```bash
git clone https://gitee.com/Vanishi/xcnvs.git
cd xcnvs
```

##### 2. 启动emb_server
```bash
cd emb_server
# 创建虚拟环境（可选）
python -m venv venv
# 激活虚拟环境
# Windows: venv\Scripts\activate
# Linux: source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 启动服务
python emb_server.py
```

##### 3. 启动xcnvs_admin
```bash
cd ../xcnvs_admin
# 创建虚拟环境（可选）
python -m venv venv
# 激活虚拟环境
# Windows: venv\Scripts\activate
# Linux: source venv/bin/activate
# 安装依赖
# Windows: pip install -r requirements.txt
# Linux: pip install -r requirements-linux.txt
# 启动服务
python manage.py runserver 0.0.0.0:9824
```

##### 4. 访问系统
打开浏览器访问：http://localhost:9824

### 更新记录
* 更新记录文档 https://beixiaocai.yuque.com/org-wiki-beixiaocai-vo72oa/xcnvs/rvk3y1a5ta6da17d

### 详细文档
* 编译文档 https://beixiaocai.yuque.com/org-wiki-beixiaocai-vo72oa/xcnvs/tyci21yfcedxrsui
* 完整使用文档 https://beixiaocai.yuque.com/org-wiki-beixiaocai-vo72oa/xcnvs

### 软件相关截图
<img width="720" alt="v2.6" src="https://gitee.com/Vanishi/images/raw/master/xcnvs/v2.6/1.png">
<img width="720" alt="v2.6" src="https://gitee.com/Vanishi/images/raw/master/xcnvs/v2.6/2.png">
<img width="720" alt="v2.6" src="https://gitee.com/Vanishi/images/raw/master/xcnvs/v2.6/3.png">

### 授权协议

- 本项目自有代码使用宽松的MIT协议，在保留版权信息的情况下可以自由应用于各自商用、非商业的项目。
但是本项目也零碎的使用了一些其他的第三方库，由于使用本项目而产生的商业纠纷或侵权行为一概与本项目及开发者无关，请自行承担法律风险。
在使用本项目代码时，也应该在授权协议中同时表明本项目依赖的第三方库的协议，以及遵循相应的规定。

### 贡献指南

欢迎提交Issue和Pull Request来帮助改进项目！

### 联系方式

- 作者：北小菜
- 主页：https://www.yuturuishi.com
- 邮箱：通过作者主页联系

### 致谢

感谢所有为项目做出贡献的开发者和用户！