MCPcopy Index your code
hub / github.com/frappe/books

github.com/frappe/books @v0.36.0 sqlite

repository ↗ · DeepWiki ↗ · release v0.36.0 ↗
1,794 symbols 4,975 edges 270 files 22 documented · 1%
README

Frappe Books logo

Frappe Books

Modern Accounting Made Simple

GitHub release (latest by date) Platforms Publish

Frappe Books Preview

<a href="https://frappe.io/books">Website</a>
-
<a href="https://docs.frappe.io/books">Documentation</a>

Frappe Books

Frappe Books is an open-source accounting software aimed at simplifying financial management for businesses. With its clean and user-friendly interface, it streamlines accounting tasks for small and medium-sized enterprises, offering a seamless solution for modern businesses to manage their finances with ease.

Screenshots

Pos

<img  alt="General Ledger" src="https://github.com/user-attachments/assets/58d8bcdf-1576-4008-b010-7054fb64a12d" />





<img  alt="Profit and Loss" src="https://github.com/user-attachments/assets/11bd67d1-d808-496b-ac4d-ef68c18b9419" />

Motivation

Frappe Books addresses a market gap where small businesses face expensive, complex accounting tools. It offers an intuitive, open-source solution that combines simplicity with essential features, empowering businesses to manage finances effectively—even offline.

Key Features

  • Dashboard: Provides an overview of key financial data and performance metrics.
  • Point of Sale: Simplifies retail transactions with an integrated POS system for easy sales processing.
  • Works Offline: Enables users to continue working without an internet connection and sync later.
  • Double-entry accounting: Ensures accurate financial tracking by recording each transaction in two accounts.
  • Entries
  • Invoicing: Allows businesses to create and manage professional invoices effortlessly.
  • Billing: Billing processes by generating bills and tracking payments.
  • Payments: Records and tracks payments received and made.
  • Journal Entries: Records financial transactions in the general ledger with detailed notes and adjustments.
  • Financial Reports
  • General Ledger: Centralized record of all financial transactions, providing a comprehensive view of accounts.
  • Profit and Loss Statement: Summarizes revenues, costs, and expenses to show business profitability.
  • Balance Sheet: Displays a company’s assets, liabilities, and equity at a specific point in time.
  • Trial Balance: Verifies the accuracy of accounting records by ensuring that debits and credits are balanced.

Under the Hood

  • Vue.js: In Frappe Books, Vue.js powers the front-end, enabling a reactive and component-based UI. It ensures seamless interactions and dynamic updates, giving users a modern, responsive experience.

  • Electron: Electron is used to package Frappe Books as a standalone desktop application, allowing it to run offline and provide a native-like experience across Windows, macOS, and Linux.

  • SQLite: Frappe Books uses SQLite as its local database. All financial data, transactions, and configurations are stored securely in an SQLite file on the user's machine.

Production Setup

Manual

Download and install the latest release for your platform from the releases page .

Using Homebrew (for MacOS and Linux)

brew install --cask frappe-books

Via Flatpak (Linux)

Get it on Flathub

Development Setup

Pre-requisites

To get the dev environment up and running you need to first set up Node.js v20.18.1 and npm. For this, we suggest using nvm.

Next, you will need to install yarn.

Clone and Run

Once you are through the Pre-requisites, you can run the following commands to setup Frappe Books for development and building:

# clone the repository
git clone https://github.com/frappe/books.git

# change directory
cd books

# install dependencies
yarn

To run Frappe Books in development mode (with hot reload, etc):

# start the electron app
yarn dev

Note: First Boot

When you run yarn dev electron will run immediately but the UI will take a couple of seconds to render this because of how dev mode works. Each file is individually served by the dev server. And there are many files that have to be sent.

Note: Debug Electron Main Process

When in dev mode electron runs with the --inspect flag which allows an external debugger to connect to port 5858. You can use chrome for this by visiting chrome://inspect while Frappe Books is running in dev mode.

See more here.

Build

To build Frappe Books and create an installer:

# start the electron app
yarn build

Note: Build Target By default the above command will build for your computer's operating system and architecture. To build for other environments (example: for linux from a windows computer) check the Building section at electron.build/cli.

So to build for linux you could use the --linux flag like so: yarn build --linux.

Want to Just Try Out or Contribute?

If you want to contribute to Frappe Books, please check our Contribution Guidelines. There are many ways you can contribute even if you don't code:

  1. If you find any issues, no matter how small (even typos), you can raise an issue to inform us.
  2. You can help us with language support by contributing translations.
  3. If you're an ardent user you can tell us what you would like to see.
  4. If you have accounting requirements, you can become an ardent user. 🙂

If you want to contribute code then you can fork this repo, make changes and raise a PR. (see how to)

Translation Contributors

Language Contributors
Arabic taha2002, Faridget, Osama Muhammed
Catalan Dídac E. Jiménez
Chinese - Simplified wcxu21, wolone, Ji Qu
Chinese - Traditional Ethan Deng
Danish Tummas Joensen
Dutch RijckAlex, Stan M
French DeepL, mael-chouteau, joandreux
German DeepL, barredterra, promexio, C2H6-383, 0xflotus, Tim
Gujarati dhruvilxcode, 4silvertooth
Hindi bnsinghgit
Indonesian Aji Prakoso
Korean Isaac-Kwon
Portuguese DeepL, Valdir Amaral
Spanish talmax1124, delbertf, Ignacio Chemes
Swedish papplo, Crims-on
Turkish Eyuq, XTechnology-TR

Learn and connect

Extension points exported contracts — how you extend this code

CountryInfo (Interface)
(no doc)
utils/types.ts
BackendResponse (Interface)
(no doc)
utils/ipc/types.ts
GetAllOptions (Interface)
(no doc)
utils/db/types.ts
ErrorLog (Interface)
(no doc)
fyo/utils/types.ts
Telemetry (Interface)
(no doc)
fyo/telemetry/types.ts
AuthConfig (Interface)
(no doc)
fyo/core/authHandler.ts
SinglesMap (Interface)
(no doc)
fyo/model/types.ts
GetQueryBuilderOptions (Interface)
(no doc)
backend/database/types.ts

Core symbols most depended-on inside this repo

t
called by 594
fyo/utils/translation.ts
push
called by 220
fyo/model/doc.ts
getNewDoc
called by 142
fyo/core/docHandler.ts
getDoc
called by 131
fyo/core/docHandler.ts
sync
called by 125
models/inventory/StockManager.ts
get
called by 87
fyo/demux/config.ts
exists
called by 79
fyo/core/dbHandler.ts
append
called by 76
fyo/model/doc.ts

Shape

Function 803
Method 628
Class 246
Interface 98
Enum 19

Languages

TypeScript100%

Modules by API surface

fyo/model/doc.ts84 symbols
models/baseModels/Invoice/Invoice.ts66 symbols
src/utils/search.ts55 symbols
backend/database/core.ts54 symbols
models/helpers.ts52 symbols
src/utils/ui.ts43 symbols
main/preload.ts39 symbols
fyo/utils/errors.ts37 symbols
fyo/core/dbHandler.ts34 symbols
models/baseModels/Payment/Payment.ts33 symbols
reports/AccountReport.ts29 symbols
models/inventory/StockTransfer.ts28 symbols

Dependencies from manifests, versioned

@codemirror/autocomplete6.4.2 · 1×
@codemirror/lang-vue0.1.1 · 1×
@codemirror/state6.0.0 · 1×
@codemirror/view6.0.0 · 1×
@electron/rebuild3.4.1 · 1×
@lezer/common1.0.0 · 1×
@popperjs/core2.10.2 · 1×
@types/assert1.5.6 · 1×
@types/electron-devtools-installer2.2.0 · 1×
@types/lodash4.14.179 · 1×

For agents

$ claude mcp add books \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact