TaxHacker：自托管的 AI 记账应用，让票据、发票和交易自动变成结构化账本
你是否曾经被散落一地的收据、PDF 发票、银行账单和手工录入 Excel 的重复劳动所困扰？TaxHacker 的出现，旨在彻底解决这个问题。它是一个基于 TypeScript 构建、可自托管的 AI 记账应用，可以帮助自由职业者、独立开发者和中小企业用大模型自动识别、提取、分类和整理财务数据，把报税和记账这件事变得轻松一点。
截至收录：
TaxHacker stars数：6705
TaxHacker forks数：1090
TaxHacker项目目录截图
TaxHacker项目核心亮点
- 🤖 AI 自动识别票据与发票：上传收据照片、发票 PDF 或银行账单，TaxHacker 会自动提取日期、金额、商家、税项、明细等关键信息，并保存为结构化数据库记录。
- 🧩 高度自定义字段、分类与项目：你可以像在 Excel 中加列一样创建无限自定义字段，也可以自定义分类、项目和 AI 提示词，适配不同国家、行业和业务习惯。
- 🌍 多币种自动换算，甚至支持加密货币：自动识别文档中的货币，并按交易发生日的历史汇率换算成基准货币，覆盖 170+ 法币和 BTC、ETH、LTC、DOT 等 14 种加密货币。
- 🔐 自托管与数据所有权：通过 Docker 部署在自己的服务器上，财务文档、数据库和上传文件都掌握在自己手中，支持完整导出和迁移，避免供应商锁定。
- 🔌 自由选择 LLM：支持 OpenAI、Google Gemini、Mistral，也可以接入本地模型，如 Ollama、LM Studio、vLLM、LocalAI 等 OpenAI 兼容端点。
- 📊 全文搜索、筛选与导出：支持按日期、分类、项目、金额和自定义字段筛选，可导出 CSV 并附带原始文档，方便交给会计师或用于报税准备。
- 🐳 Docker 原生部署：官方提供 Docker 镜像和 Docker Compose 配置，一条命令即可拉起应用和 PostgreSQL 数据库，并自动执行数据库迁移。
TaxHacker项目快速开始
只需几步，你就能在本地运行起 TaxHacker：
- 拉取 Docker Compose 配置并启动：
bash
curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml
docker compose up - 访问应用：
打开浏览器访问：
bash
http://localhost:7331 - 按需配置环境变量：
生产或长期使用建议配置以下变量：
env
UPLOAD_PATH=./data/uploads
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/taxhacker
SELF_HOSTED_MODE=true
BETTER_AUTH_SECRET=your-secure-random-key
PORT=7331 - 本地开发方式（可选）：
bash
git clone https://github.com/vas3k/TaxHacker.git
cd TaxHacker
npm install
cp .env.example .env
npx prisma generate && npx prisma migrate dev
npm run dev
注意：处理 PDF 需要安装 Ghostscript 和 GraphicsMagick，macOS 可执行brew install gs graphicsmagick。
TaxHacker项目应用场景
场景一：自由职业者与独立黑客记账：拍照上传收据或发票，AI 自动提取金额、商家、日期和税项，减少手工录入 Excel 的时间，让季度报税和年度整理更轻松。
场景二：小微企业多项目核算：通过自定义项目、分类和字段，把不同客户、不同业务线、不同成本中心的收支分开管理，生成更清晰的经营报表。
场景三：跨国交易与多币种管理：经常使用外币订阅、海外采购或加密货币收款时，TaxHacker 可按历史汇率自动换算，统一到基准货币进行统计和导出。
场景四：隐私敏感的财务数据管理：对数据隐私要求较高的用户，可以把 TaxHacker 部署在自己的 NAS、家庭服务器或云主机上，让财务文档不离开自己的基础设施。
场景五：给会计师准备报税材料：筛选指定时间段、分类或项目的交易，导出 CSV 和原始文档，快速整理成会计或税务顾问需要的材料。
用户案例：目前 TaxHacker 仍处于早期开发阶段，README 中尚未列出大型企业用户案例；它主要面向愿意自托管、重视数据所有权、希望用 AI 自动化记账流程的自由职业者、独立开发者和中小团队。项目作者也提醒，当前版本仍在快速演进，建议先尝鲜并做好数据备份。
TaxHacker项目链接
GitHub 仓库：https://github.com/vas3k/TaxHacker
支持项目：https://vas3k.com/donate/
开源协议：MIT License
vas3k / TaxHacker项目地址：https://github.com/vas3k/TaxHacker
本文地址：https://www.tgoos.com/46368
