【亲测免费】 Magic-BI 开源项目使用教程

1. 项目介绍

Magic-BI 是一个基于人工智能的全自动聊天式BI产品，目前支持SQL数据库。它是一款开源产品，可以完全私有或半私有部署，这样可以最大程度地保护用户隐私，同时降低使用门槛。

Magic-BI 与其他聊天BI产品相比，具有以下优势：

• 数据安全：Magic-BI 可以完全使用闭源模式运行，防止内部数据或元数据的泄露。
• 构建成本：Magic-BI 可以使用零或最小用户输入训练数据进行模型微调，显著降低使用成本。
• 易用性：Magic-BI 提供了完整的训练数据生成、模型微调、部署功能，用户可以通过简单的页面操作完成这些任务，显著降低了产品使用门槛。

2. 项目快速启动

环境要求

• 操作系统：Ubuntu 22.04
• 显卡：RTX 4090
• CUDA：12+
• PyTorch：2.0+

安装方法

Docker部署（推荐）

1. 安装Docker并启用GPU支持。
2. 克隆项目到本地：

   git clone https://github.com/chaos-water/Magic-BI.git
   

3. 进入项目目录并启动服务：

   cd Magic-BI
   docker compose -f deployment/docker-compose.yml up -d
   

Pip安装

1. 安装PostgreSQL开发库（根据操作系统选择相应命令）：

   # Ubuntu/Debian
   sudo apt-get update
   sudo apt-get install libpq-dev
   
   # CentOS/Fedora/RHEL
   sudo yum install postgresql-devel
   
   # macOS
   brew install postgresql
   

2. 执行以下命令安装Magic-BI：

   pip install magic-bi
   

源码编译

1. 进入项目目录：

   cd Magic-BI
   

2. 执行以下命令安装依赖：

   pip3 install -e .
   

3. 启动服务：

   docker compose -f deployment/docker-compose.yml up -d
   docker compose -f deployment/docker-compose-component.yml up -d
   

启动客户端

• WEB GUI：执行以下命令启动系统，然后在浏览器中访问 http://127.0.0.1:6688。

  python3 -m magic_bi.main --config config/system.yml
  

• Restful API：执行同样的命令启动系统，然后使用API工具或其他系统调用Magic-BI。

3. 应用案例和最佳实践

（此部分将根据具体应用场景和最佳实践进行补充，包括但不限于数据接入、数据分析和报告生成等。）

4. 典型生态项目

（此部分将介绍与Magic-BI相互配合使用的其他开源项目或工具，例如数据存储、数据清洗、可视化工具等。）