https://github.com/moonmao42/receiptbi

Local-first business intelligence for files and read-only databases.
https://github.com/moonmao42/receiptbi

business-intelligence data-analysis data-visualization database fastapi local-first natural-language-to-sql nextjs python react reporting self-hosted semantic-layer sql text-to-sql text2sql

Last synced: 6 days ago
JSON representation

Local-first business intelligence for files and read-only databases.

• Host: GitHub
• URL: https://github.com/moonmao42/receiptbi
• Owner: MoonMao42
• License: mit
• Created: 2025-08-21T02:42:02.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2026-07-23T08:47:04.000Z (16 days ago)
• Last Synced: 2026-07-23T09:11:34.764Z (16 days ago)
• Topics: business-intelligence, data-analysis, data-visualization, database, fastapi, local-first, natural-language-to-sql, nextjs, python, react, reporting, self-hosted, semantic-layer, sql, text-to-sql, text2sql
• Language: Python
• Homepage:
• Size: 20.9 MB
• Stars: 38
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          




# ReceiptBI

**将 CSV、Excel 和只读数据库转换为可核查、可编辑的业务报表。**

[下载桌面版](https://github.com/MoonMao42/ReceiptBI/releases/latest) · [使用示例数据](#使用示例数据) · [English](README.en.md)

[![CI](https://github.com/MoonMao42/ReceiptBI/actions/workflows/ci.yml/badge.svg)](https://github.com/MoonMao42/ReceiptBI/actions/workflows/ci.yml)

[![Release](https://img.shields.io/github/v/release/MoonMao42/ReceiptBI?label=release)](https://github.com/MoonMao42/ReceiptBI/releases/latest)

[![License](https://img.shields.io/github/license/MoonMao42/ReceiptBI)](LICENSE)



![查看报表分页并进入编辑布局](docs/images/demo/receiptbi-report-demo.gif)

可以通过自然语言和数据库、Excel 等进行只读交互，生成图表，汇总


## 使用示例数据

1. 安装 [ReceiptBI 桌面版](https://github.com/MoonMao42/ReceiptBI/releases/latest)，或从源码启动。

2. 下载 [咖啡零售订单示例](examples/retail/orders.csv)。

3. 在设置中配置模型服务，将示例文件加入项目。

4. 输入以下问题：

> 请分析最近一个月的销售额、毛利和退款，并按地区和渠道比较。

## 下载

当前版本为 [ReceiptBI 1.0.0](https://github.com/MoonMao42/ReceiptBI/releases/tag/v1.0.0)。

macOS 首次打开

1. 打开 DMG，将 ReceiptBI 拖入“应用程序”文件夹。

2. 当前 1.0.0 版本尚未签名。如果 macOS 阻止首次打开，请在终端运行：

```bash

xattr -cr /Applications/ReceiptBI.app

```

## 核心特性

### 完整分析过程，含重点和图表

![包含核心指标、关键发现和图表的数据调查](docs/images/zh/workspace-analysis.png)

### 按数据源 AI 生成语义层

![按数据表查看和治理业务定义](docs/images/zh/semantic-governance.png)

### 转换为可编辑报表

![将一次调查整理为报表前的内容确认](docs/images/zh/report-organizing.png)

### 导出前预览分页

![多页报表的打印预览](docs/images/zh/report-print-preview.png)



[⭐ Star ReceiptBI](https://github.com/MoonMao42/ReceiptBI)



## 工作流

```mermaid

flowchart LR

    data["文件 / 只读数据库"] --> prep["准备数据"]

    prep --> semantic["确认业务背景"]

    semantic --> ask["提出问题"]

    ask --> run["进行分析"]

    run --> validate["核查依据"]

    validate -->|还需调整| run

    validate --> report["可编辑报表"]

```

已确认的数据准备步骤和业务定义会被保存。数据更新但结构未变时，可沿用原有口径重新运行分析并刷新报表。

## 历史版本

| 版本 | 基础项目 | 分支 |

|---|---|---|

| v2 | [gptme](https://github.com/gptme/gptme) | [v2](https://github.com/MoonMao42/ReceiptBI/tree/v2) |

| v1 | [Open Interpreter 0.4.3](https://github.com/OpenInterpreter/open-interpreter) | [v1](https://github.com/MoonMao42/ReceiptBI/tree/v1) |

## 许可证

[MIT](LICENSE)