vas3k/TaxHacker

项目概览

可重点关注其覆盖 170 多种法定货币和 14 种常见加密货币的历史汇率自动换算能力是否持续稳定。

项目类型

AI 工作流 · 模型运行 · 文档处理

应用场景

文档办公

部署方式

查看项目说明

License

MIT

适合谁

• 适合希望减少收据和发票手工录入，并需要结构化交易记录的自由职业者与小型企业。
• 适合需要处理多种法定货币或常见加密货币，并希望自动按历史汇率归一化记录的用户。
• 适合重视财务数据控制、能够自行维护容器化应用、数据库和模型服务的个人或技术团队。

核心能力

• 上传收据照片或发票 PDF 后，系统自动识别日期、金额、供应商和明细项目，对信息进行分类并保存为结构化交易数据。该能力已经可用，可减少手工录入，但关键财务字段仍应人工核验。
• 系统自动检测原始币种，并使用历史汇率换算到基础货币；当前已支持 170 多种法定货币和 14 种常见加密货币，便于汇总跨币种交易。
• 可将人工智能处理指向兼容 OpenAI 接口的本地大模型端点，从而减少对外部模型服务的依赖。该能力已经可用，但实际识别质量取决于所选模型的光学字符识别能力。
• 用户可创建不限数量的自定义字段、项目和交易类别，用自己的业务维度组织财务记录，适合按客户、项目或费用类型进行后续筛选。
• 可针对字段、类别和项目编写提示词，也可修改内置提示词，以控制模型如何提取和归类信息。该能力适合需要业务定制的用户，但调整后仍需用真实凭证验证效果。
• 用户可以查看和筛选完整交易历史，将记录导出为 CSV，并保留关联文档，用于生成便于报税准备和复核的资料。
• 项目提供本地存储和自托管选项，使组织能够自行控制财务数据，并降低对单一托管供应商的依赖。该能力已经可用，部署与运维责任由使用者承担。
• 系统通过 Ghostscript 和 GraphicsMagick 处理发票 PDF，为后续内容识别与结构化提取提供文档处理基础。部署时需要确认相关处理组件能够正常工作。

限制与风险

• 项目明确提示仍在早期开发中，应按风险自担方式使用。用于关键财务流程前，需要先验证稳定性、数据完整性和恢复流程。
• 本地模型的处理结果没有保证，实际表现取决于模型对光学字符识别任务的能力；较弱模型可能影响字段提取与分类质量。
• 接入外部模型服务时，财务文档可能进入外部处理边界，数据质量和隐私责任由使用者承担，因此需要在启用前完成内部评估。

如何开始

• 下载 docker-compose.yml，运行 docker compose up，然后通过 localhost:7331 访问网页界面。首次成功前还需要完成 PostgreSQL 和环境变量配置。
• 可配置外部模型服务的接口密钥，或部署兼容接口的本地模型。使用本地模型时，显卡不是强制要求，但应先验证模型对光学字符识别任务的处理质量。

核验依据

• GitHub 项目简介: Self-hosted AI accounting app. LLM analyzer for receipts, invoices, transactions with custom prompts and categories
• README: This project is still in early development. Use at your own risk! **Star us** to get notified about new features and bugfixes ⭐️
• README: TaxHacker is a self-hosted accounting app designed for freelancers, indie-hackers, and small businesses who want to save time and automate expense and income tracking using the po…
• README: Upload photos of receipts, invoices, or PDFs, and TaxHacker will automatically recognize and extract all the important data you need for accounting: product names, amounts, items,…
• README: AI data extraction: Use AI to automatically pull key information like dates, amounts, vendors, and line items

内容核验时间：