レシートを撮るだけでAIが自動仕分け！フリーランスのための自分専用AI経理アプリ — TaxHacker

アーキテクチャ・技術スタック

• フロントエンド＆API: Next.js 15+
• ORM（データベース操作ライブラリ）: Prisma
• データベース: PostgreSQL 17+（推奨）
• PDF処理: Ghostscript + GraphicsMagick
• コンテナ: Docker / Docker Compose対応
• 認証: Better Auth（BETTER_AUTH_SECRETで設定）

対応AIプロバイダー

ローカルLLM対応は今後予定されています。

主要機能一覧

• AI文書解析: レシート・請求書・銀行明細・手書き領収書など多種多様な文書を認識
• 多言語・多通貨対応: あらゆる言語の文書を処理可能。170以上の通貨＋14種の仮想通貨（BTC, ETH, LTC, DOTなど）
• 取引日ベースの為替換算: ヒストリカルレート（過去の実際のレート）で自動変換
• アイテム分割: 1つの請求書内の個別商品をそれぞれ独立した取引として分割可能
• カスタムフィールド: Excelの列を追加するように、独自の項目を無制限に作成可能
• カスタムプロンプト: システムプロンプトを含むすべてのAI指示文を編集可能
• 全文検索: OCR認識済み文書の中身を横断検索
• 一括操作: 複数の文書やトランザクションをまとめて処理
• CSVエクスポート: フィルタリング結果を添付文書付きでエクスポート
• マルチプロジェクト対応: 複数のプロジェクトやクライアントごとに取引を管理

環境変数（主要なもの）

制約・注意点

• 現在は早期開発段階であり、本番運用は自己責任
• ローカルLLM（自分のPCで動くAI）は現時点では未対応（今後対応予定）
• AIによる解析にはOpenAI、Google Gemini、MistralいずれかのAPIキーが必要（外部サービスとの通信が発生）

ライセンス

• MITライセンス: 商用利用を含め自由に利用可能

デプロイ方式

• GitHub Container Registry（ghcr.io/vas3k/taxhacker）から公式Dockerイメージを取得可能
• リリースごとにバージョンタグ付きイメージが自動ビルド・公開される
• 起動時にデータベースマイグレーションが自動実行される

Dockerでのセルフホスト（推奨）

# docker-compose.ymlをダウンロード
curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml

# 起動（データベースも自動セットアップ）
docker compose up

http://localhost:7331 にアクセスして利用開始できます。

ローカル開発環境

git clone https://github.com/vas3k/TaxHacker.git
cd TaxHacker
npm install
cp .env.example .env
# .envファイルでDATABASE_URLなどを設定
npx prisma generate && npx prisma migrate dev
npm run dev

PDF処理にはGhostscriptとGraphicsMagickが必要です（macOSの場合: brew install gs graphicsmagick）。