myinvoice  by radekhulan

Self-hosted invoicing and accounting system

Created 2 months ago
268 stars

Top 95.5% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> MyInvoice.cz is an open-source, self-hosted invoicing and accounting system designed for freelancers, sole proprietors (OSVČ), and small businesses. It offers a privacy-focused alternative to SaaS solutions, providing users with full control over their financial data. The system aims to reduce operational costs by eliminating monthly fees while delivering comprehensive features for managing invoices, clients, and basic accounting.

How It Works

The application employs a modern web stack with a PHP backend (Slim framework) and a Vue.js frontend, powered by MariaDB. It emphasizes a self-hosted architecture, allowing deployment on private or rented servers. Key technical differentiators include AI-driven PDF extraction for incoming invoices using Anthropic Claude (BYOK), robust multi-supplier capabilities from a single installation, and deep integration with Czech and EU financial standards and services like ARES, VIES, ISDOC, and Pohoda XML exports.

Quick Start & Requirements

The quickest setup is via Docker, achievable in approximately 3 minutes. This requires Docker Desktop (Windows/macOS) or Docker Engine + compose-plugin (Linux). Alternatively, a native installation is supported, demanding PHP 8.5+, MariaDB 10.6+, Composer 2.x, Node.js 22+, and pnpm 10+. The Docker image is lightweight, around 92MB with ~26MB idle RAM. Official documentation is available at MyInvoice.cz/manual.

Highlighted Details

  • AI-powered extraction of data from PDF invoices using Anthropic Claude (Bring Your Own Key).
  • Full multi-supplier functionality, enabling invoicing for multiple companies (IČO) from one instance.
  • Extensive Czech and EU financial integrations, including ARES/VIES lookups, SPAYD/SEPA QR codes, ISDOC, and Pohoda XML exports.
  • A comprehensive CRM dashboard featuring KPIs, aging reports, and cash flow forecasts.
  • A REST API (v1) with 101 endpoints for programmatic access.
  • Integrated document management with full-text search and folder structures.
  • Automated generation of DPH (VAT) and income tax reporting XML files.

Maintenance & Community

The project is developed by MyWebdesign.cz s.r.o. While specific community channels like Discord or Slack are not detailed in the README, the project is actively maintained with regular releases and an in-app upgrade mechanism.

Licensing & Compatibility

MyInvoice.cz is released under the MIT License. This permits free use, modification, and redistribution, including for commercial purposes, provided the original copyright and license text are retained. It is compatible with closed-source linking under these terms.

Limitations & Caveats

Users are solely responsible for the accuracy of invoices and compliance with local tax and accounting legislation. The system has specific limitations regarding OSS (self-supply) and SK (Slovakia) 23% VAT rates, with suggested workarounds. AI extraction requires a user-provided Anthropic API key. The README explicitly states that the correctness of invoices is always the user's responsibility, and professional accounting advice should be sought for non-standard situations.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
17
Issues (30d)
45
Star History
27 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.