TaxHacker

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 1100 🐛 待处理 52 👀 关注 52

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 6812

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可自行部署，无付费版本。

项目预览

项目数据

分类开源模型

开发团队vas3k

官网地址https://taxhacker.app

GitHubhttps://github.com/vas3k/TaxHacker

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 6812

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

代码更新2026-10-31

仓库体积20.0 MB

本站数据更新2026-11-10

维护状态较活跃

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6812

技术标签

gemini llm ocr-recognition ollama openai

使用教程

难度：入门约 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`