Django Ledger is a powerful financial management system built on the Django Web Framework. It offers a simplified API for handling complex accounting tasks in financially driven applications.

Join our Discord | Documentation | QuickStart Notebook

• High-level API
• Double entry accounting
• Hierarchical Chart of Accounts
• Financial statements (Income Statement, Balance Sheet, Cash Flow)
• Purchase Orders, Sales Orders, Bills, and Invoices
• Financial ratio calculations
• Multi-tenancy support
• Ledgers, Journal Entries & Transactions
• OFX & QFX file import
• Closing Entries
• Inventory management
• Unit of Measures
• Bank account information
• Django Admin integration
• Built-in Entity Management UI

• Feature Requests/Bug Reports: Open an issue in the repository
• For software customization, advanced features and consulting services: Contact us or email msanda@arrobalytics.com
• Contribute: See our contribution guidelines

We're looking for contributors with:

• Python and Django programming skills
• Finance and accounting expertise
• Interest in developing a robust accounting engine API

If you have relevant experience, especially in accounting, we welcome your pull requests or direct contact.

Django Ledger is a Django application. If you haven't, you need working knowledge of Django and a working Django project before you can use Django Ledger. A good place to start is here.

Make sure you refer to the django version you are using.

The easiest way to start is to use the zero-config Django Ledger starter template. See details here. Otherwise, you may create your project from scratch.

To create a new Django Ledger project:

• Make sure you have the latest version of python here (recommended).

• Install Django:

pip install django

• Install Python Pipenv (python package manager):

pip install pipenv

• Go to your desired development folder and create a new django project:

django-admin startproject django_ledger_project && cd django_ledger_project

• Install Django on you virtual environment.

pipenv install django

• Install Django Ledger

pipenv install django-ledger[graphql,pdf]

• Activate your new virtual environment:

pipenv shell

• Add django_ledger to INSTALLED_APPS in you new Django Project.

INSTALLED_APPS = [
    ...,
    'django_ledger',
    ...,
]

• Perform database migrations:

python manage.py migrate

• Add Django SuperUser and follow the prompts.

python manage.py createsuperuser

• Add URLs to your project's urls.py:

from django.urls import include, path

urlpatterns = [
    ...,
    path('ledger/', include('django_ledger.urls', namespace='django_ledger')),
    ...,
]

• Run your project:

python manage.py runserver

• Navigate to Django Ledger root view assigned in your project urlpatterns setting ( typically http://127.0.0.1:8000/ledger if you followed this installation guide).
• Use your superuser credentials to login.

Django Ledger comes with a basic development environment already configured under dev_env/ folder not to be used for production environments. If you want to contribute to the project perform the following steps:

1. Navigate to your projects directory.
2. Clone the repo from github and CD into project.

git clone https://github.com/arrobalytics/django-ledger.git && cd django-ledger

3. Install PipEnv, if not already installed:

pip install -U pipenv

4. Create virtual environment.

pipenv install

If using a specific version of Python you may specify the path.

pipenv install --python PATH_TO_INTERPRETER

5. Activate environment.

pipenv shell

6. Apply migrations.

python manage.py migrate

7. Create a Development Django user.

python manage.py createsuperuser

8. Run development server.

python manage.py runserver

1. Navigate to your projects directory.

2. Give executable permissions to entrypoint.sh

sudo chmod +x entrypoint.sh

3. Add host '0.0.0.0' into ALLOWED_HOSTS in settings.py.

4. Build the image and run the container.

docker compose up --build

5. Add Django Superuser by running command in seprate terminal

docker ps

Select container id of running container and execute following command

docker exec -it containerId /bin/sh

python manage.py createsuperuser

6. Navigate to http://0.0.0.0:8000/ on browser.

After setting up your development environment you may run tests.

python manage.py test django_ledger