Skip to content

Releases: roger296/lucaV0.5

v0.5.0 — First Public Release

22 Apr 09:05

Choose a tag to compare

Luca General Ledger v0.5.0

The first public release of Luca — an AI-driven general ledger with a cryptographic audit trail, built for small and medium businesses.

Highlights

  • 50 MCP tools for conversational accounting via Claude
  • SHA-256 hash-linked chain file — tamper-evident, append-only audit trail with Merkle tree verification
  • PostgreSQL mirror database — fast querying and reporting, rebuildable from chain files at any time
  • 14 transaction types — journals, invoices, payments, bank imports, payroll, depreciation, and more
  • Approval workflow — auto-approve or queue for review based on configurable rules
  • Period management — open, soft-close, and hard-close with sequential enforcement
  • Bank reconciliation — CSV/OFX import and matching
  • Year-end close — automated P&L zeroing with opening balance carry-forward
  • React web UI — dashboard, journal, chart of accounts, approval queue, trial balance
  • One-command VPS install — Docker, nginx, Let's Encrypt SSL, systemd — all automated
  • OAuth 2.0 + PKCE MCP server for secure Claude integration
  • 564 tests across 33 suites, all passing

New in v0.5.0

  • Luca's Log — per-installation business knowledge document that Luca builds and maintains over time, enabling contextual accounting decisions
  • Consequential transactions — Luca detects implied transactions (COGS, delivery accruals, prepayments) from business context
  • GL document posting skill — structured workflow for analysing financial documents and posting to the GL
  • Tax reference files — UK, US, and EU VAT/tax rules
  • CFO advisory framework — business analysis, cash flow monitoring, and strategic advice
  • CI pipeline — GitHub Actions running full test suite with PostgreSQL
  • Community health files — CONTRIBUTING.md, SECURITY.md, CHANGELOG.md, issue and PR templates
  • Luca Community License v1.0 — free for business and personal use; commercial licence required for hosted services, distribution, and commercial add-ons

Getting Started

See the README for installation instructions, or the Getting Started guide for a step-by-step Windows walkthrough.

Luca General Ledger v1.0.0

04 Apr 14:22

Choose a tag to compare

Luca General Ledger — Initial Release

A complete AI-driven accounting platform built around a cryptographic hash-chain ledger.

What's included

  • 50 MCP tools for Luca AI agent to manage the ledger conversationally
  • Double-entry engine — every transaction balances, validated at every step
  • Cryptographic chain ledger — SHA-256 hash-linked chain files with Merkle tree verification
  • Period management — open → soft-close → hard-close with chain sealing
  • Bank reconciliation — CSV/JSON import, HIGH/MEDIUM/LOW confidence auto-matching
  • Document intake pipeline — file inbox scanning and processing state tracking
  • Multi-currency — exchange rates and FX revaluation at period end
  • JWT authentication and RBAC (Admin, Finance Manager, Approver, Viewer)
  • Webhook event system — HMAC-signed delivery with exponential backoff retry
  • Setup & onboarding engine — Xero, Sage, QuickBooks CSV import
  • Batch run support — scheduled overnight processing with task logging
  • Two AI skillslucas-general-ledger and luca-setup
  • React frontend — dashboard, journal, approval queue, period management
  • 520 tests passing across 32 test suites

Quick start

docker compose up -d
npm install
npm run migrate
npm run seed
npm start

See GETTING_STARTED.md for full setup instructions.