🧾 TaxHacker — Your Personal AI Accountant

Self-hosted accounting app crafted for freelancers, indie-hackers and small businesses. Let AI scan your receipts, analyze your expenses, convert currencies, and get your taxes in order.

Built with Next.js 16, React 19, Prisma 7, and PostgreSQL. Made with ❤️ in India.

✨ Features

🤖 AI-Powered Document Analysis

Upload receipts or invoices as photos or PDFs for automatic recognition
Extract key information like dates, items, and vendors
Works with any language and any photo quality
Automatically organize everything into a structured database
Bulk upload and analyze multiple files at once

💱 Multi-Currency Support

Automatically detects foreign currencies and converts them to yours
Knows historical exchange rates for the transaction date
Supports 170+ world currencies and popular cryptocurrencies (BTC, ETH, LTC, etc.)
Manual entry always available as a fallback

📊 Transactions, Categories & Projects

Fully customizable categories, projects, and custom fields
Add, edit, and manage your transactions
Filter by any column, category, or date range
Customize which columns to show in the table
Import transactions from CSV

📋 Invoice Generator

Advanced invoice generator to create invoices in any language
Edit any field, even labels and titles
Export invoices to PDF or as transactions
Save invoices as templates to reuse later
Native support for included and excluded taxes (VAT, GST, etc.)

🎨 Full Control Over AI

Expand and improve your instance with custom LLM prompts
Create custom fields/categories and tell AI how to parse them
Extract any additional information you need
Automatically categorize by project or category
Ask AI to assess risk level or any other criteria
Bring your own keys: OpenAI, Google Gemini, Mistral

📦 Your Data — Your Rules

100% self-hosted for complete privacy
Export transactions to CSV for tax prep
Full-text search across documents and invoices
Download your full data archive at any time — we never lock your data

🛠️ Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router)
UI	React 19, Tailwind CSS 4, Radix UI
Database	PostgreSQL with Prisma 7 ORM
Auth	Better Auth (email OTP)
AI/LLM	LangChain + OpenAI / Google Gemini / Mistral
Emails	Resend
Payments	Stripe (optional)
Deployment	Docker, Docker Compose

⚠️ Required Environment

Node.js ≥ 26 (see .nvmrc)
PostgreSQL database (local or hosted)
One AI provider API key (Gemini recommended — free)

🚀 Quick Start (Local Development)

1. Install dependencies

npm install

2. Configure environment

Create a .env file in the project root:

# Core
NODE_ENV=development
PORT=7331
BASE_URL=http://localhost:7331

# Database (required)
DATABASE_URL=postgresql://USER:PASSWORD@localhost:5432/taxhacker

# Auth
BETTER_AUTH_SECRET=a-very-long-random-secret-at-least-16-chars

# AI (pick at least one — Gemini is free via Google AI Studio)
GOOGLE_API_KEY=your-gemini-api-key
GOOGLE_MODEL_NAME=gemini-2.5-flash

# Emails (optional, for OTP login in cloud mode)
RESEND_API_KEY=re_your-resend-key
RESEND_FROM_EMAIL=TaxHacker <onboarding@resend.dev>

3. Run database migrations

npx prisma migrate deploy

4. Start the dev server

npm run dev

Open http://localhost:7331 in your browser.

🐳 Deployment with Docker

The project includes a multi-stage Dockerfile and several docker-compose files.

Option 1: Complete stack (app + cron + PostgreSQL)

Use docker-compose.build.yml to build locally:

# Set required env first
export POSTGRES_PASSWORD=your-db-password
export BETTER_AUTH_SECRET=your-long-secret

# Build and start
docker compose -f docker-compose.build.yml up -d --build

Migrations run automatically on startup. The app will be available at http://localhost:7331.

Option 2: Use the prebuilt image

docker compose up -d

Docker Compose services

Service	Description
`app`	The Next.js web application (port 7331)
`cron`	Background jobs (email sync, log rotation)
`postgres`	PostgreSQL 17 database

Data persistence: Uploads are stored in ./data and the database in ./pgdata — both are mounted as volumes.

☁️ Two Operating Modes

TaxHacker can run in two modes, controlled by the SELF_HOSTED_MODE env variable:

Mode	`SELF_HOSTED_MODE`	Login for users?	Best for
Self-hosted	`true`	❌ No login (single shared user)	Personal / private / local use
Cloud	`false`	✅ Email-OTP signup & login	Sharing with multiple users

Self-hosted mode (`SELF_HOSTED_MODE=true`)

Everyone who opens the app uses one shared workspace — no signup, no payment
No email provider or Stripe needed
Ideal for a personal instance or a trusted team on a private network

Cloud mode (`SELF_HOSTED_MODE=false`)

Each user signs up with their email + OTP code
Requires a Resend API key to send OTP emails
Optional Stripe for paid subscriptions
Ideal for a public SaaS you share with others

🎯 Deploying to the Cloud (Free, No Credit Card)

For a free, no-credit-card deployment you can share with others, use:

Service	Purpose	Free tier
Render.com	Web hosting (Docker)	750 hrs/month, spins down when idle
Neon / Supabase	PostgreSQL database	512 MB storage
Resend	OTP emails (cloud mode only)	100 emails/day
Google AI Studio	Gemini API key (AI)	Generous free tier

Step-by-step on Render

Push this repo to GitHub.
Sign up at render.com (free, no card).
Create a New → Web Service, connect your GitHub repo.
Set Environment to Docker.
Add the environment variables from the section below.
Click Create Web Service — Render builds & deploys automatically.
Done! You get a free https://your-app.onrender.com URL with HTTPS.

Required environment variables for Render

Variable	Value
`NODE_ENV`	`production`
`PORT`	`7331`
`BASE_URL`	`https://your-app.onrender.com` (your actual URL)
`SELF_HOSTED_MODE`	`true` (free, no login) or `false` (multi-user)
`DATABASE_URL`	Your Neon/Supabase Postgres connection string
`BETTER_AUTH_SECRET`	A random string ≥ 16 chars
`GOOGLE_API_KEY`	Your free Gemini key
`GOOGLE_MODEL_NAME`	`gemini-2.5-flash`
`RESEND_API_KEY`	Only if cloud mode (`false`)
`RESEND_FROM_EMAIL`	Only if cloud mode (`false`)

Important: BASE_URL must match your public URL exactly (including https://). It's used for OTP links and redirects.

Generate a strong auth secret:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Setting up an AI provider (free)

Go to Google AI Studio
Sign in → Create API key
Paste it as GOOGLE_API_KEY

📧 Environment Variables Reference

Variable	Required	Default	Description
`BASE_URL`	✅	`http://localhost:7331`	Public URL of the app
`PORT`		`7331`	Port the app listens on
`SELF_HOSTED_MODE`		`true`	`true` = no login, `false` = cloud login
`DATABASE_URL`	✅	—	PostgreSQL connection string
`BETTER_AUTH_SECRET`	✅	—	Auth secret (≥ 16 chars)
`DISABLE_SIGNUP`		`false`	Set `true` to block new signups
`GOOGLE_API_KEY`		—	Gemini API key
`GOOGLE_MODEL_NAME`		`gemini-2.5-flash`	Gemini model
`OPENAI_API_KEY`		—	OpenAI API key
`OPENAI_MODEL_NAME`		`gpt-4o-mini`	OpenAI model
`MISTRAL_API_KEY`		—	Mistral API key
`MISTRAL_MODEL_NAME`		`mistral-medium-latest`	Mistral model
`RESEND_API_KEY`	cloud only	—	Resend key for OTP emails
`RESEND_FROM_EMAIL`	cloud only	—	Verified sender email
`RESEND_AUDIENCE_ID`		—	Resend audience for newsletters
`STRIPE_SECRET_KEY`	optional	—	Stripe payments
`STRIPE_WEBHOOK_SECRET`	optional	—	Stripe webhooks
`UPLOAD_PATH`		`/data/uploads`	Where uploads are stored

A copy-paste template with descriptions is available in .env.example.production.

🗂️ Project Structure

components/        # React UI components (dashboard, forms, transactions, etc.)
app/               # Next.js App Router pages & API routes
lib/               # Core logic (auth, db, config, email, files, stats)
models/            # Database models / data access layer
prisma/            # Prisma schema & migrations
ai/                # AI/LLM integration (providers, prompts, schema)
forms/             # Form validation schemas (Zod)
hooks/             # Custom React hooks
public/            # Static assets (images, fonts, landing media)
docs/              # Additional documentation
types/             # TypeScript type definitions

🧪 Testing & Linting

# Run the test suite (Vitest)
npm test

# Run tests in watch mode
npm run test:watch

# Lint the codebase
npm run lint

📖 Additional Documentation

DEPLOYMENT.md — Free, no-credit-card deployment guide
docs/self-hosted-public-access.md — Exposing self-hosted instances publicly
docs/migrate-0.3-0.5.md — Migrating data from older versions

🛠️ Troubleshooting

OTP email not arriving

Check Resend dashboard → Logs for delivery status.
Emails from onboarding@resend.dev may land in Spam. Verify a domain in Resend for better delivery.

Database connection error

Ensure DATABASE_URL is correct and includes ?sslmode=require for hosted databases like Neon.

"Signup is disabled"

You have SELF_HOSTED_MODE=true or DISABLE_SIGNUP=true. For open signups set both to false.

Uploads fail / "file too large"

The app allows up to 256 MB uploads by default. Increase bodySizeLimit in next.config.ts if needed.

"next: command not found" in Docker

This is fixed in the current Dockerfile (uses the explicit binary path). Pull the latest image.

🤝 Contributing

This is an open-source project. Contributions, bug reports, and feature requests are welcome!

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📬 Contact

Made with ❤️ in India by @Daksh

Support / Contact: djain00009@gmail.com
Source Code: github.com/Daksh200/Invoice_IQ

📄 License

🙏 Acknowledgements

Built using Next.js, Prisma, Better Auth, LangChain, and Tailwind CSS

Name		Name	Last commit message	Last commit date
.github		.github
ai		ai
app		app
components		components
docs		docs
etc		etc
forms		forms
hooks		hooks
lib		lib
models		models
prisma		prisma
public		public
types		types
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.nvmrc		.nvmrc
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierrc		.prettierrc
Dockerfile		Dockerfile
README.md		README.md
components.json		components.json
docker-compose.build.yml		docker-compose.build.yml
docker-compose.production.yml		docker-compose.production.yml
docker-compose.yml		docker-compose.yml
docker-cron-entrypoint.sh		docker-cron-entrypoint.sh
docker-entrypoint.sh		docker-entrypoint.sh
eslint.config.mjs		eslint.config.mjs
instrumentation-client.ts		instrumentation-client.ts
instrumentation.ts		instrumentation.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
prisma.config.ts		prisma.config.ts
proxy.ts		proxy.ts
sentry.edge.config.ts		sentry.edge.config.ts
sentry.server.config.ts		sentry.server.config.ts
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Latest commit

History

Folders and files

Repository files navigation