whatisgithub

What is quints?

sealambda/quints — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · pm founderComplexity · 3/5Setup · moderate

In one sentence

A command line accounting tool for small Swiss companies that handles VAT returns, official statements, and QR-bill invoices in plain text books, meant to be driven by an AI coding agent.

Mindmap

mindmap
  root((quints))
    What it does
      Swiss VAT filing
      QR bill invoicing
      Statutory statements
    Tech stack
      Python
      beancount
      Fava
    Use cases
      File quarterly VAT returns
      Generate year end statements
      Track unpaid invoices
    Audience
      Swiss small businesses
      Accountants and bookkeepers
    Design
      Driven by AI coding agent
      Deterministic CLI
      Plain text books

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

File a Swiss micro-company's quarterly VAT return in the official Form-310 format.

USE CASE 2

Generate legally formatted year-end balance sheet and income statement PDFs for an auditor or accountant.

USE CASE 3

Send Swiss QR-bill invoices that are automatically cross-checked against the company's own ledger.

USE CASE 4

Import UBS, Wise, or Stripe statements into a review area before they are added to the books.

What is it built with?

PythonbeancountFava

How does it compare?

sealambda/quints2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/53/5
Audiencepm founderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10 or newer and familiarity with plain-text accounting concepts from beancount.

No license information is stated in the README.

So what is it?

quints is a command line tool that helps small Swiss companies handle their bookkeeping in plain text files instead of proprietary accounting software. It builds on top of an existing plain text accounting system called beancount, and it adds the specific paperwork a small Swiss business, whether a GmbH, an AG, or a sole proprietorship, actually has to produce: quarterly VAT returns, official statutory financial statements, and Swiss style QR bill invoices. A notable design choice is that quints is meant to be operated by an AI coding agent such as Claude Code, rather than by a person typing commands directly, or at least alongside one. The tool itself never calls an AI model. Instead it stays a predictable, checkable command line program: the agent proposes bookkeeping entries in plain text, and quints validates them and reports back whether they are correct. Setting up a new set of books scaffolds a project with a chart of accounts already matched to the official Swiss KMU accounting framework, a folder structure for yearly transaction files, and instruction files that tell a coding agent how to extend and check the books going forward. From there, the tool can print the official quarterly VAT form, list unpaid customer invoices by due date, generate a year end balance sheet and income statement as a PDF in the correct legal format, fetch official Swiss exchange rates and calculate year end currency revaluations, and turn bank or payment provider statements into draft entries that wait in a review folder rather than going straight into the books. It can also generate a Swiss QR bill invoice as a PDF and check that its total matches what is actually recorded in the ledger. Installation is a single command using a Python package installer such as uv, pipx, or pip, and it requires Python 3.10 or newer. The project is made up of several smaller packages, including separate importers for UBS, Wise, and Stripe statements, all published together and pulled in automatically when quints itself is installed.

Copy-paste prompts

Prompt 1
Help me scaffold a new quints project for my Swiss GmbH with sample books included.
Prompt 2
Show me how to run quints mwst to generate my quarterly VAT return for this quarter.
Prompt 3
Use my AI coding agent to propose bookkeeping entries and validate them with quints check.
Prompt 4
Walk me through generating a Swiss QR-bill invoice with quints and checking it against my ledger.

Frequently asked questions

What is quints?

A command line accounting tool for small Swiss companies that handles VAT returns, official statements, and QR-bill invoices in plain text books, meant to be driven by an AI coding agent.

What language is quints written in?

Mainly Python. The stack also includes Python, beancount, Fava.

What license does quints use?

No license information is stated in the README.

How hard is quints to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is quints for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.