Skip to main content

Fane

把支付宝、微信账单变成 Beancount,管理分类、订阅、账本与查询。入口是 fa。

uv tool install .
fa -c config/bill.local.yaml config init
fa -c config/bill.local.yaml config check

Python 3.11+,macOS/Linux。开发安装用 uv pip install -e .。 配置可以用 fa -c PATH,也可以一次设置:

export FANE_CONFIG=/path/to/fane.yaml
export FANE_LEDGER=/path/to/main.bean

常用命令:

fa convert -p wechat -s bill.xlsx
fa bill sync daily --write --json
fa classify extract | your-classifier | fa classify apply --write
fa sub generate --write
fa check
fa query 2026-09-01 2026-09-30
fa serve --host 127.0.0.1 --port 8080

命令可以通过 JSON/JSONL 组合。启用 shell 的 pipefail 可以传播前一步失败:

set -o pipefail
fa convert -p wechat -s bill.xlsx -f jsonl | fa ingest journal --write

账本写入命令默认预览,--write 才修改账本。n8n 的 fa flow 按流程操作执行。 命令显式注册,功能按业务目录拆卸。旧导入壳、动态别名、插件注册与旧命令均已移除。 查询兼容原 ledger-query 的 /health 和 /query,不调用 Flova。

需要什么 文档
安装与工作流 使用
全部参数与指令契约 命令
YAML、规则与订阅 配置
目录和拆卸 模块
rn 部署与 n8n 自动化

rn 使用 uv 安装 Fane,由 systemd 的 fane.service 管理查询进程;n8n 通过内部网络调用它。部署定义见 服务。 项目同时支持 Docker,从项目根目录执行 docker build -f deploy/Dockerfile -t fane .;Docker 构建只包含程序源码,不包含 token 或本地账本。

Metadata

Release files for Fane 2.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Fane 2.2.0
File Size Uploaded
fane-2.2.0.tar.gz 95.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Fane 2.2.0
File Interpreter ABI Platform
fane-2.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 193.7 kB

Release files / fane-2.2.0.tar.gz

Download URL fane-2.2.0.tar.gz
Size 95.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0e635ee2e9bb01df11751d58a250bd9d908eeb5f67f2b6cbb451b04f552e4734
BLAKE2b-256 checksum
How to use checksums
537493350bb7f288a8cab38265e9174b72f53b875ce89dfbc8cb0fd361465a4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / fane-2.2.0-py3-none-any.whl

Download URL fane-2.2.0-py3-none-any.whl
Size 97.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cefceacc9020354ebaf42d7e099bb1aa0e38ed32c7e247dc22b86913d684eeab
BLAKE2b-256 checksum
How to use checksums
d71d6cf8d084531899b7b05222a5ddabdd043d1a71cecc05a8badaf7a6996a2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release history Release notifications | RSS feed

This release

2.2.0 This release

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.5.0

2 release files

1.4.10

2 release files

1.4.9

2 release files

1.4.8

2 release files

1.4.7

2 release files

1.4.5

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.9

2 release files

1.2.8

2 release files

1.2.7

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page