monthlytracker/README.md

Monthy Tracker

Private monthly expense tracking with local-first storage, offline category suggestions, and offline monthly insights via Ollama.

Local app

1. Install dependencies:

npm install

2. Create env config from .env.example and keep your local runtime settings:

cp .env.example .env

3. Apply migrations and start the app:

npx prisma migrate deploy
npm run dev

4. Keep Ollama running with the configured model:

ollama serve
ollama pull qwen3.5:9b

Docker Compose

Start both the app and Ollama together:

docker compose up --build

This compose stack will:

• start Ollama
• pull qwen3.5:9b through the ollama-init service
• start the Next.js app on http://localhost:3000
• persist the SQLite database and pulled model with named Docker volumes

In-app helpers

• Use the dashboard runtime panel to refresh Ollama status.
• If the configured model is missing, use Pull configured model from the UI.
• Use Download backup to export the current SQLite database file.

Environment

• DATABASE_URL - Prisma SQLite connection string
• OLLAMA_URL - local or container Ollama base URL
• OLLAMA_MODEL - selected model tag, default qwen3.5:9b