Skip to main content

Flowkeep

Flowkeep 把个人自动化的 webhook、只读账本查询、财务适配和服务器启停合成一个可安装的项目。配置与业务数据留在服务器,源码留在本地。

uv tool install 'flowkeep[download]'
flowkeep --config /path/to/flowkeep.toml config check
flowkeep webhook serve
flowkeep finance prepare --offline --date 2026-10-03
flowkeep finance finish --write --decisions-base64 'BASE64_JSON'
flowkeep service start
flowkeep service check
flowkeep service pack

仅运行 ledger 时安装 uv tool install 'flowkeep[ledger]',用 flowkeep ledger serve 启动,或 flowkeep ledger query --start YYYY-MM-DD --end YYYY-MM-DD 查询。

flowkeep download -p alipay --download-config /path/to/download.json 使用现有下载库的提供者工厂,并明确读取配置路径,不再改写第三方包源码。

flowkeep-download download 提供旧 dflow 命令的参数和 JSON 兼容入口,服务器 dflow 入口指向它。

默认配置 /root/.flow/config/flowkeep.toml。支持 ${ENV_NAME} 占位符,缺失变量直接报错。模板见 examples/。--config 和 --root 是全局参数,放在功能指令前。FLOWKEEP_CONFIG、FLOWKEEP_ROOT 可设置默认位置。

Webhook 验证 GitHub HMAC SHA256,只响应指定分支的 push;同一仓库同步互斥,保持旧服务的 fetch/reset/clean 镜像同步语义。因此应指向自动部署仓库,不应指向有未提交人工改动的开发目录。同步后的可选 HTTP hook 由配置指定;失败记录类型,不把凭据或请求正文写入日志。

账本接口保持 GET /health 和 POST /query,字段 start_date、end_date、max_transactions,仍输出 schema_version=1、收入/支出/资产负债变动、分录及警告。日期范围最多366天;查询只读。

财务功能只编排 fa、下载提供者和 oub;Fane 负责解析、模板、去重和分类。prepare --offline 不下载、解压、写交易、调用AI或推送。finish 不带 --write 为预览;未配置实际订阅计划时明确失败,不假装成功。

服务指令读取服务器 config/services.json 和唯一 config/compose.yaml。启动重复执行不会重建正在运行的容器。打包短暂停止 webhook、暂停容器以复制一致数据,立即恢复,再导出镜像。包保留 n8n 配置和所有权,包含秘密,应私有保存。

新服务器使用相同 Python 3.12 和 x86_64,事先安装 Docker/Compose、Git,并安装 uv;解包至 /root 后执行 /root/.flow/start.sh。SSH 私钥、域名 DNS 及 n8n SSH 服务器地址需单独迁移。

开发:uv sync --all-extras,uv run python -m unittest discover -s tests,uv run ruff check src tests。发布:PYPI_TOKEN_FILE=/private/path/token ./release.sh --yes。token 不进入项目分发包。

部署与迁移见 服务器说明,完整参数见 指令参考,财务流程见 n8n说明。发布新版本前先提高 pyproject.toml 版本号,PyPI 已发布版本不能覆盖。

Metadata

Release files for flowkeep 0.1.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 flowkeep 0.1.1
File Size Uploaded Provenance Actions
flowkeep-0.1.1.tar.gz 33.7 kB Without provenance Details for flowkeep-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 57.4 kB

Release files / flowkeep-0.1.1.tar.gz

Download URL flowkeep-0.1.1.tar.gz
Size 33.7 kB
Tags Source
SHA-256 checksum
How to use checksums
afe06edfa8854ba4494bb02d6eaba491ae89c11a5abb1809ee7dc8bc2587dd23
BLAKE2b-256 checksum
How to use checksums
415345aea9eb0e9c3ee75449fe4b326ecfb507a89fd53276d285e141254dd744
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / flowkeep-0.1.1-py3-none-any.whl

Download URL flowkeep-0.1.1-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc47f23f3f01e10c3a2b4ccaa8691283f0be3f3e340c7c00cbfa10747f344f90
BLAKE2b-256 checksum
How to use checksums
9d090190fdba28a742accaa7a4f025a1a92be5ff657c80bd1e529dd7b56190de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for flowkeep 0.1.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