TaxHacker

自托管AI记账，自动识别单据，省心整理财务

TaxHacker 是一个自托管的 AI 记账应用，利用大语言模型自动分析收据、发票和银行交易，帮助个人或小企业简化财务记录与税务准备。它通过自定义提示词和分类规则，将非结构化的财务单据转化为结构化账目，解决手动录入繁琐、分类不准的问题。核心能力包括：支持多种单据格式的智能识别与提取、灵活的自定义分类体系、本地化部署保障数据隐私，以及可扩展的规则引擎。用户可自行配置模型和提示词，适应不同国家的税务规则和记账习惯。项目基于 TypeScript 开发，界面简洁，适合技术用户快速搭建个人财务数据管道。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6715

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队vas3k

所属国家

官网地址https://taxhacker.app

GitHubhttps://github.com/vas3k/TaxHacker

定价模式free

价格说明开源项目，MIT许可证，可自行部署，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型accounting,ai-analysis,currency-exchange,expenses,gemini,invoices,llm,ocr-recognition,ollama,openai,self-hosted,taxes

GitHub 星标★ 6715

30天Star增速

HF 下载量

上线时间2025-03-10 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：Docker 4 步

环境要求

已安装 Docker 与 Docker Compose
可访问网络以下载 docker-compose.yml 与 ghcr.io 镜像
可选：本机已安装 Node.js 与 npm（用于本地源码开发）
可选：一个 PostgreSQL 17+ 数据库（不提供则使用 Compose 内置数据库）

安装与启动步骤

1下载 Compose 文件

从官方仓库拉取 docker-compose.yml 到当前目录，Compose 内含应用容器、PostgreSQL 17+ 与启动时自动迁移。
```
curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml
```
2启动服务

在 docker-compose.yml 所在目录执行，首次会拉取预构建镜像并创建数据库与数据卷。
```
docker compose up
```
3自定义配置(可选)

按需修改 compose：映射 7331 端口、设置 SELF_HOSTED_MODE、UPLOAD_PATH 与 DATABASE_URL，并挂载持久化数据卷。
4本地源码开发(可选)

不使用 Docker 时，先安装 Node 依赖，再复制环境变量模板并按需编辑 .env。
```
npm install
cp .env.example .env
```

关键配置

配置项	必填	说明	示例
`ports`	否	应用对外暴露的端口映射，默认配置示例为 7331。	`7331:7331`
`SELF_HOSTED_MODE`	否	标记为自托管模式运行。	`true`
`UPLOAD_PATH`	否	上传单据的存储路径。	`/app/data/uploads`
`DATABASE_URL`	否	PostgreSQL 连接串，可指向自带或已有数据库。	`postgresql://postgres:postgres@localhost:5432/taxhacker`
`volumes`	否	挂载持久化数据目录，避免容器重建后数据丢失。	`./data:/app/data`

如何确认成功

容器正常启动后，浏览器访问 http://localhost:7331 ，能打开 TaxHacker 界面即部署成功。

常见问题

Q：如何指定某个版本而不是最新版？

A：把镜像标签从 latest 换成具体版本标签（如 ghcr.io/vas3k/taxhacker:v1.0.0），每次发版都会自动构建并发布新镜像。

Q：可以用我自己的数据库吗？

A：可以。修改 DATABASE_URL 指向已有 PostgreSQL 17+ 实例，不必使用 Compose 内置数据库。

Q：数据会上传到云端吗？

A：不会，这是自托管应用，数据存放于本地数据卷和数据库；请确保按示例挂载 ./data:/app/data 做持久化。

Q：本地不用 Docker 怎么跑？

A：执行 npm install 安装依赖，再 cp .env.example .env 并按 README 提示编辑环境变量后启动。

注意事项

项目仍处于早期开发阶段，README 提示使用风险自负。
所有容器启用了 no-new-privileges 安全选项。
启动时会自动执行数据库迁移，首次启动可能稍慢。
生产环境建议使用固定版本标签而非 latest。

核心亮点

支持收据、发票、交易记录多类型自动识别，减少手动输入
自定义提示词和分类规则，灵活适配个人或地区税务要求
自托管部署，财务数据完全掌控，隐私安全

不足之处

需要用户自行配置LLM API密钥，有一定技术门槛
文档/社区待观察

适用场景

自由职业者自动整理年度收支与税务抵扣项
小企业快速录入报销单据并生成分类报表
注重隐私的个人用户本地部署财务分析工具

替代项目

Firefly III、Actual Budget、InvoiceNet

项目介绍

TaxHacker 是行业应用领域的开源项目，由 vas3k 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（6,715）位列前 7%，在行业应用分类的 545 个项目里位列前 5%。

近 41 天，它的 GitHub 星标从 6,607 增加到 6,715，净增 108。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，可自行部署，无付费版本。

它主要面向的使用场景是：自由职业者自动整理年度收支与税务抵扣项。同类可对比的替代方案包括 Firefly III、Actual Budget、InvoiceNet。

上一篇：PentestGPT

下一篇：osmedeus