Documentation

Documentation

Chaque page est un fichier du dépôt, rendu à la construction du site : elle dit ce que fait le code de la même version. Ce qui n’est pas encore écrit le dit. Les articles sont rédigés en anglais.

Commencer ici

Ce qu’est Ekwo OS, et une commande entre un projet Supabase gratuit et une première facture.

  • Ekwo OS en une page

    Ekwo OS is free and open source data infrastructure for accounting, finance and tax, under AGPL-3.0: a schema, the rules of each country as data, and tools, for businesses and…

  • Commencer avec Claude : Ekwo sur votre propre comptabilité

    Vous utilisez déjà Claude ? Un projet Supabase gratuit, une commande, le serveur MCP connecté dans Claude Desktop ou Claude Code — puis votre propre comptabilité reprise,…

  • Pour un agent IA qui aide à utiliser Ekwo OS

    Ce dont un agent IA a besoin pour installer Ekwo OS pour quelqu’un et tenir sa comptabilité : où lire, les commandes et les outils, et ce qu’il ne doit jamais faire.

  • Installer Ekwo OS sur votre propre projet Supabase

    D’un compte Supabase gratuit à une première facture : une commande applique le schéma, charge les règles du pays et crée la première société — puis les quatre réglages qu’aucun…

Tenir la comptabilité

La ligne de commande, le serveur MCP auquel un agent se connecte, le client TypeScript et les bibliothèques de formats.

Pays

Un pays est un pack de fichiers, pas du code. Comment on l’écrit, le traduit et le vérifie.

  • Packs pays

    A country is data. Everything Belgium or France adds to Ekwo — a chart of accounts, journals, VAT codes, the accounts each of them posts to, the boxes of the periodic return — is…

  • Langues

    Accounting is done in a language. A Belgian company keeps its books in French, in Dutch or in German; its accountant reads the chart of accounts in one of them, and the National…

  • Au-delà des premiers pays

    A country is data, not code. A module of code per country breaks at every major version, and one product per market splits the users. Ekwo ships one core and one versioned pack…

Faire tourner une entreprise

Déposer une déclaration, un cabinet et ses clients, partager un document, déménager une société, et les modules.

  • La vie d’une déclaration

    A VAT return is not a report. A report is asked for and answers; a declaration leaves the building, an administration keeps a copy, money follows it, and six months later somebody…

  • Un cabinet comptable et ses clients

    An accounting firm, a fiduciary, a bookkeeper with thirty customers, a group that keeps the books of its three subsidiaries: somebody who keeps several companies that are not all…

  • Partager un document

    A company sends an invoice and the customer wants to look at it: what it says, what is still owed on it, what the law put at its foot. Everything needed to answer already exists…

  • L’archive d’une société

    A firm keeps the books of N companies in one installation, and each of them belongs to somebody. export_company() writes one company out, whole, in a format that needs nothing of…

  • Reprendre une comptabilité tenue ailleurs

    Somebody who wants to try Ekwo on their own books arrives with them. They come from another package, or from nowhere in particular — a spreadsheet — and what they hold is the same…

  • Modules

    The socle is public: companies, accounts, taxes, entries, documents, the reports. What is built beside it lives here, one folder and one schema per module.

Référence

Chaque table et chaque fonction, la correspondance avec les normes, et chaque décision de conception avec sa raison.

Contribuer

Comment une pull request est acceptée, comment s’écrit un module, comment la comptabilité est testée en volume, comment une version est publiée.

  • Contribuer à Ekwo OS

    Thank you for being here. This file is short and every line of it is a rule that has cost somebody a day.

  • Écrire un module

    A module is a Postgres schema beside the socle. assets holds fixed assets and their depreciation; budgets holds a plan and compares it to the ledger. The socle stays in public and…

  • La comptabilité en volume

    What is known about how the schema behaves when there is something in it, how it is known, and what is still a guess.

  • Comment une version est publiée

    A release of Ekwo OS is one tag carrying the migrations, the country packs and the npm packages together. There is no "down": a database that has run a migration cannot be walked…

À propos d’Ekwo

Pourquoi il est construit, ce qu’il ne promet pas, et où signaler une faille.

  • Pourquoi nous construisons Ekwo

    Every business on earth keeps books. The books say whether it is alive, whether it can pay its people next month, whether it can afford to try something. For most small…

  • Ce qu’est Ekwo, et ce qu’il n’est pas

    Ekwo OS is open source data infrastructure: a database schema, rules written as data, format libraries and tools, for businesses and for the accountants who work with them. It is…

  • Signaler une faille

    Ekwo OS holds books. A flaw here is not a crash, it is a company reading another company's ledger, or an entry that posts without a trace. Please report it, and please report it…