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 不进入项目分发包。

Metadata

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

Built distribution (wheel)

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

Total release size: 49.5 kB

Release files / flowkeep-0.1.0.tar.gz

Download URL flowkeep-0.1.0.tar.gz
Size 25.9 kB
Tags Source
SHA-256 checksum
How to use checksums
dec1aebe669bc0dad357168776ae529c1a58c091d8d9194760f23079bc895782
BLAKE2b-256 checksum
How to use checksums
6d56254bccf850b39d27896b68221d10a0c3ef9852e887c6d24ebc71b085b05f
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.0-py3-none-any.whl

Download URL flowkeep-0.1.0-py3-none-any.whl
Size 23.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ac8d276bba1f2bd47981a953d96508b77926ffc226b50c85554b8369fcc4e5e5
BLAKE2b-256 checksum
How to use checksums
a4774987cc918feed4c2521e60eef71c351db6ab77640aef9a08df09a8a4449a
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.0

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