本文为原文前 6,000 字符的节选翻译，完整内容请查看原文。

BillCraft AI: Invoice Generator + AI-Powered Invoice Reader

Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle Submission 💸 This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle What I Built BillCraft AI is a privacy-first, intelligent invoice studio built for freelancers, contractors, and small business owners. It automates the tedious work of creating invoices and digitizing messy receipts without sending private financial data to third-party cloud servers.

Hacktoberfest 开源 AI 挑战赛第 2 周：副业项目提交 💸 这是我为 Hacktoberfest 开源 AI 挑战赛第 2 周提交的副业项目。我构建的 BillCraft AI 是一个以隐私为先的智能发票工作室，专为自由职业者、承包商和小型企业主打造。它能够自动化处理创建发票和数字化杂乱收据的繁琐工作，且无需将私人财务数据发送到第三方云服务器。

The Problem It Solves Freelancers and solopreneurs spend hours every month manually deciphering paper receipts, supplier invoices, and re-typing numbers into spreadsheets. Mainstream SaaS accounting tools charge costly monthly subscriptions ($30–$70/mo) and upload sensitive financial documents, client names, and banking details to proprietary cloud APIs.

它解决的问题：自由职业者和个体创业者每月都要花费数小时手动解读纸质收据、供应商发票，并将数字重新输入到电子表格中。主流的 SaaS 会计工具收取昂贵的月费（每月 30-70 美元），并将敏感的财务文档、客户姓名和银行详细信息上传到专有的云 API 中。

The Solution BillCraft AI solves this through two streamlined workflows: Smart Invoice Generator: A fast workspace with persistent business profiles saved in local storage, dynamic real-time totals, one-click AI item description enhancement, and pixel-perfect branded PDF generation. AI Invoice & Receipt Reader: A drag-and-drop document scanner that reads any PDF or image receipt using local OCR (RapidOCR + PyMuPDF), extracts structured line items via open-weight Qwen 2.5 7B, validates math integrity on the server, and transfers extracted data into the generator in a single click.

解决方案：BillCraft AI 通过两个精简的工作流程解决了这些问题：智能发票生成器：一个快速的工作区，具有保存在本地存储中的持久化业务资料、动态实时总计、一键式 AI 项目描述增强以及像素级完美的品牌 PDF 生成功能。AI 发票与收据阅读器：一个拖放式文档扫描仪，使用本地 OCR（RapidOCR + PyMuPDF）读取任何 PDF 或图像收据，通过开源权重模型 Qwen 2.5 7B 提取结构化行项目，在服务器上验证数学完整性，并一键将提取的数据传输到生成器中。

How I Built It BillCraft AI is designed around open-weight models and local inference: Open-Weight Model: Qwen 2.5 7B (qwen2.5:7b) by Alibaba Cloud — selected for its high benchmark performance in structured JSON extraction and financial reasoning. Local Inference Engine: Ollama running locally on localhost:11434, ensuring 100% private, zero-latency inference.

我是如何构建它的：BillCraft AI 是围绕开源权重模型和本地推理设计的：开源权重模型：阿里巴巴云的 Qwen 2.5 7B (qwen2.5:7b) —— 因其在结构化 JSON 提取和财务推理方面的高基准性能而被选中。本地推理引擎：在 localhost:11434 上本地运行的 Ollama，确保了 100% 私密、零延迟的推理。

Why Does Open Innovation Matter? Absolute Data Privacy: Invoices contain sensitive client information, bank details, and pricing margins. Closed APIs process and retain this data on their servers; running open-weight Qwen 2.5 on Ollama guarantees financial data never leaves the user’s device. Zero Marginal Cost: Closed AI APIs charge per token, making bulk invoice parsing cost-prohibitive. Open weights eliminate per-token charges entirely.

为什么开放创新很重要？绝对的数据隐私：发票包含敏感的客户信息、银行详细信息和定价利润率。封闭的 API 会在服务器上处理并保留这些数据；在 Ollama 上运行开源权重的 Qwen 2.5 可以保证财务数据永远不会离开用户的设备。零边际成本：封闭的 AI API 按 Token 收费，使得批量发票解析的成本高昂。开源权重完全消除了按 Token 收费的成本。