Documentation

Documentation

Pour tenir votre comptabilité dès aujourd’hui, commencez sur Ekwo Cloud ; ces pages décrivent Ekwo OS, le cœur open source sur lequel il repose. 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 is open source accounting, ready to use on Ekwo Cloud: the web application for your invoices, your bank statements, your VAT returns and the electronic invoices your country…

  • 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…

  • Ekwo OS dans tous les 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 OS 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 tax 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 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. fixed_assets holds fixed assets and their depreciation; budgets holds a plan and compares it to the ledger; tax estimates the…

  • La comptabilité en volume

    How the schema behaves when there is something in it, how that is checked, and what is still to be measured.

  • 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…

  • Ce qu’Ekwo sait de vous

    Ekwo is one piece of software, and you choose where your books live. The same open-source schema runs everywhere; what changes is who operates the database, and what Ekwo holds…

  • 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…