ReceiptHero：使用AI自动识别和管理收据的工具

ReceiptHero是一个开源的收据管理应用程序，它使用人工智能（AI）技术来帮助用户整理各种收据。 用户可以上传收据的图片，系统能通过光学字符识别（OCR）技术自动读取图片中的文字信息。这项技术由Together AI提供的大语言模型Llama 4 Scout 17B驱动，能够准确地从图片中提取出关键数据。 例如，系统可以识别出商家名称、消费日期、总金额、购买的商品项目、货币种类以及支付方式。 提取信息后，ReceiptHero会自动对消费进行分类，比如餐饮、购物或交通等。为了保护用户隐私，所有提取出的数据都存储在用户自己的浏览器本地，而不会上传到服务器。这个项目采用了多种现代网页技术构建，包括Next.js框架、Tailwind CSS样式库以及shadcn/ui组件库，确保了应用的美观和易用性。

功能列表

• AI驱动的OCR识别: 利用Together AI提供的Llama大语言模型，能准确地从收据图片中提取文字和数据。
• 结构化数据提取: 自动识别并提取收据中的关键信息，包括商家、日期、金额、具体项目、货币和支付方式。
• 自动费用分类: 能够将提取的消费信息自动归类到餐饮、购物、加油等不同类别中。
• 隐私保护: 所有的收据数据都存储在用户浏览器的本地存储中，不会上传到云端服务器，保证了用户数据的私密性。
• 友好的用户界面: 用户可以通过简单的拖拽或点击操作来上传收据图片。
• 消费数据可视化: 以图表和列表的形式展示消费明细，让用户可以直观地了解自己的支出情况。
• 开源免费: 整个项目是开源的，用户可以免费使用，也可以自行部署或参与二次开发。

使用帮助

ReceiptHero 是一个网页应用，主要功能是利用AI技术帮助用户扫描、识别并管理纸质收据。它将收据图片转换成结构化的数字信息，并进行自动分类，方便用户追踪个人财务状况。由于数据存储在本地浏览器中，用户的隐私得到了很好的保护。

一、如何使用ReceiptHero

该工具作为一个在线网页应用，无需安装。用户可以直接访问其官方网站 www.usereceipthero.com/ 来使用。基本操作流程如下：

1. 访问网站: 在浏览器中打开ReceiptHero的官方网址。
2. 上传收据: 网站主界面会有一个上传区域。你可以通过以下两种方式上传你的收据图片：
   • 拖拽上传：直接将电脑中的收据图片文件拖拽到上传区域。
   • 点击选择：点击上传区域，会弹出文件选择窗口，你可以浏览并选择需要上传的收据图片。
3. AI自动处理: 上传图片后，系统后台会自动调用Together AI的Llama模型进行OCR处理。这个过程需要几秒钟，系统会分析图片内容，提取出关键的消费信息。
4. 查看结果: 处理完成后，系统会将提取出的结构化数据显示在界面上。你会看到一个包含商家名称、消费日期、总金额、项目列表等信息的表格。
5. 管理和分析: ReceiptHero会自动对这笔消费进行分类（如食品、交通等），并在仪表盘或分析图表中展示你的消费分布情况。所有记录都会保存在浏览器本地，下次访问时依然可以看到历史记录。

二、本地部署（适合开发人员）

作为一个开源项目，如果你具备一定的开发知识，也可以将ReceiptHero部署到自己的电脑或服务器上。这样可以实现更高度的自定义和数据控制。

准备工作:

• Together AI 账户: 你需要注册一个Together AI的账户，以获取用于调用OCR模型的API密钥（API key）。
• Node.js环境: 确保你的电脑上安装了Node.js和npm（或pnpm）包管理工具。

安装和运行步骤:

1. 克隆代码仓库:
   打开终端（命令行工具），使用git命令将项目的源代码从GitHub克隆到本地。

   git clone https://github.com/Nutlope/receipthero.git
   

2. 进入项目目录:
   使用cd命令进入刚刚克隆下来的文件夹。

   cd receipthero
   

3. 创建环境变量文件:
   项目中有一个名为.example.env的示例文件。你需要复制它并创建一个名为.env的新文件。

   cp .example.env .env
   

   然后，使用文本编辑器打开.env文件，将你在Together AI网站获取的API密钥粘贴进去，保存文件。

4. 安装项目依赖:
   在终端中运行以下命令，该命令会自动下载并安装项目运行所需的所有软件库。

   npm install
   

   或者，如果你使用pnpm：

   pnpm install
   

5. 启动本地服务器:
   安装完成后，运行以下命令来启动开发服务器。

   npm run dev
   

   终端会显示一个本地网址，通常是 http://localhost:3000。

6. 在浏览器中访问:
   打开你的网络浏览器，访问上一步中显示的网址，你就可以在本地使用自己部署的ReceiptHero了。

应用场景

1. 个人记账与预算管理
   用户可以将日常消费的纸质收据通过手机拍照上传，ReceiptHero会自动识别并分类记账。这样可以帮助用户清晰地了解自己的消费习惯，省去了手动输入的麻烦，便于进行个人财务管理和预算控制。
2. 企业员工报销
   公司员工在出差或日常工作中会产生大量的收据和发票需要报销。员工可以利用这个工具快速将各类票据数字化，并自动提取关键信息。这不仅简化了报销流程，也方便了财务人员的审核工作。
3. 小型商家记账
   对于小型企业或个体户，这个工具可以作为一个轻量级的账目记录工具。通过扫描每日的销售小票或采购收据，可以方便地将经营数据数字化，便于后续的统计和分析。

QA

1. 这个工具是免费的吗？
   是的，ReceiptHero是一个开源项目，你可以免费使用它部署的公开网站，也可以下载源代码在自己的服务器上部署，无需支付任何费用。但需要注意的是，它依赖的Together AI服务可能有一定的免费额度限制，超出部分可能需要付费。
2. 我的收据数据安全吗？
   非常安全。根据项目介绍，所有上传的收据图片和识别出的数据都存储在用户自己的浏览器本地缓存中，并不会上传到项目的服务器进行存储，这最大程度地保护了用户的个人隐私。
3. 识别的准确率如何？
   该工具使用的是基于Llama 4 Scout 17B模型的AI OCR技术，对于打印清晰、布局标准的收据，识别准确率非常高。但如果收据有褶皱、污损或者手写字体，识别的准确度可能会受到影响。
4. 我不是开发者，可以直接使用吗？
   可以。你只需要访问该项目的官方网站 www.usereceipthero.com/ 就可以直接使用其核心功能，无需进行任何复杂的安装和配置。