https://github.com/zhang-accounting/zhang

账 - a plain text double-accounting tool which is compatible with beancount but more powerful
https://github.com/zhang-accounting/zhang

Last synced: 2 months ago
JSON representation

账 - a plain text double-accounting tool which is compatible with beancount but more powerful

• Host: GitHub
• URL: https://github.com/zhang-accounting/zhang
• Owner: zhang-accounting
• License: apache-2.0
• Created: 2021-06-01T16:19:31.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-29T05:30:21.000Z (8 months ago)
• Last Synced: 2024-06-01T01:51:42.753Z (8 months ago)
• Language: Rust
• Homepage: https://zhang-accounting.kilerd.me/
• Size: 5.73 MB
• Stars: 128
• Watchers: 2
• Forks: 11
• Open Issues: 21
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

• my-awesome - zhang-accounting/zhang - 11 star:0.2k fork:0.0k 账 - a plain text double-accounting tool which is compatible with beancount but more powerful (Rust)

README

        


  

  
账 Zhang

  
a plain text double-accounting tool.



![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/zhang-accounting/zhang/build-latest.yml)

[![](https://codecov.io/gh/zhang-accounting/zhang/branch/main/graph/badge.svg?token=AVM0HNGF91)](https://codecov.io/gh/zhang-accounting/zhang)

![Crates.io (recent)](https://img.shields.io/crates/dr/zhang)

![Docker Pulls](https://img.shields.io/docker/pulls/kilerd/zhang)

[![](https://img.shields.io/docsrs/zhang)](docs.rs/zhang)

![](https://img.shields.io/crates/l/zhang)

- Online Playground: [Online Playground](https://zhang-playground.zeabur.app/)

- Online Demo: [Online Demo](https://zhang-accounting.zeabur.app/)

- Documentation: [Documentation](https://zhang-accounting.kilerd.me/)

[![Discord Banner 2](https://discord.com/api/guilds/1217736070045896704/widget.png?style=banner2)](https://discord.gg/EGjwhnV267)

[![testflight icon](/assets/TestFlight_Light.svg)](https://testflight.apple.com/join/3pm50he2)

## Quick Start

To quickly get started with Zhang, you can use Docker to install and run the service:

```shell

docker pull kilerd/zhang:latest

docker run --name zhang -v "/your/data/path:/data" -p "8000:8000" kilerd/zhang:latest

```

This will pull the latest Zhang Docker image and run it, exposing the service on port 8000.

## Features

- **Independent Directive**: all directives in zhang are independent, you can write them in any file with any order.

- **More Precise Control**: features, like commodity decimal precision and datetime supported for directive, provide

  more control

- **Document Management Enhancement**: zhang has a good document management feature to allow you collect and control

  document easier and effective, like receipts.

- **New Functionalities**: The latest version introduces enhanced budget management, improved error handling, and

  support for multiple currencies.

### Compatibility with beancount

beancount and zhang are both text based accounting tools, and they are some familiar.

But zhang deprecates some directives, like `note`, `pad` and `push_tag`, and also evolves some directives,

like `balance`. So your beancount file may not be compatible with zhang, we will provide a tool to convert beancount

format to zhang format, and vice versa.

## Documentation

For detailed setup and installation guides, please refer to the [documentation](https://zhang-accounting.kilerd.me/).

## Community and Support

Join our [Discord server](https://discord.gg/EGjwhnV267) for community discussions, support, and to stay updated with

the latest news. For iOS users, you can join our TestFlight to try out the latest

features [here](https://testflight.apple.com/join/3pm50he2).

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=zhang-accounting/zhang&type=Date)](https://star-history.com/#zhang-accounting/zhang&Date)