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.1

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.1
File Size Uploaded Provenance Actions
fane-2.2.1.tar.gz 76.4 kB Without provenance Details for fane-2.2.1.tar.gz

Built distribution (wheel)

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

Total release size: 176.2 kB

Release files / fane-2.2.1.tar.gz

Download URL fane-2.2.1.tar.gz
Size 76.4 kB
Tags Source
SHA-256 checksum
How to use checksums
270872283d426574b569906c52d76af78e108cbec101240fb1362420fb552633
BLAKE2b-256 checksum
How to use checksums
580eda473e5a790ff542e85bf296c7f2d76b9f89c1a3b32dda4ecca87edde795
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.1-py3-none-any.whl

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

Security for Fane 2.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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