mflowy AGENTS.md

mflowy AGENTS.md is an instructions file for Codex, OpenCode from ifoodsci-ai/mflowy. It costs 1,856 tokens per session, scanned A, original, MIT.

Repository instructions for MFlowy, a Python workflow engine whose features are exposed through MCP tools, a standard way for programs to offer callable capabilities to AI agents. They describe project structure, commands, conventions, and common setup traps.

In plain words
What is it for?
They are for running tests, formatting and linting code, starting the MCP server, using modeling features, and understanding the project’s layered architecture and distribution methods.
Why use it?
They give coding agents the repository-specific rules they need when the code alone does not explain them.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ifoodsci-ai/mflowy/agents-md
Clone the repo
git clone --depth 1 https://github.com/ifoodsci-ai/mflowy

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mflowy AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ifoodsci-ai/mflowy/agents-md.svg)](https://agentmods.dev/instructions/ifoodsci-ai/mflowy/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/ifoodsci-ai/mflowy/agents-md"><img src="https://agentmods.dev/badge/instructions/ifoodsci-ai/mflowy/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,856 This file is loaded in full into every session.
When invoked 1,856 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01856 $0.01856
Opus 5 $0.00928 $0.00928
Sonnet 5 $0.00371 $0.00371
Haiku 4.5 $0.00186 $0.00186

Measured 3d ago against content hash 3d207689a10c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

mflowy AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

AI 编码 agent 在本仓库的唯一指引。代码是真相源——本文件只写代码里查不到的东西:约定、理由、陷阱、流程。存疑先探索再假设;动态文件树用 tree --gitignore 现查。

Project

MFlowy:YAML 配置驱动的模块化 ML 工作流引擎,全部能力以 MCP tools(pyfunc)暴露——MCP server(stdio)、JSON runner(K8s Job 容器)、直接 import 三入口。

Language: Python 3.12 | 代码注释与文档:中文

开发命令

uv sync --all-extras --all-groups   # 首次/依赖变更后
make test                           # 全量测试
make lint && make fmt               # ruff
uv run cmd list_modules                          # base 能力(无数据栈)
uv run --extra modeling cmd modeling '{"modeling_steps_yaml": "...", "name": "...", "desc": "..."}'
uv run mcpSrv                                     # MCP server(stdio)

用户态分发(PyPI/uvx/wheel/Docker)见 READMEdocker/;MCP 客户端 stdio 配置见 .mcp.json.example

uvx 陷阱(uvx 不读 pyproject 的 [tool.uv.sources]):

  • torch CPU 索引(--index https://download.pytorch.org/whl/cpu + unsafe-best-match)为 [modeling] 必需——缺省时 torch 解析为 CUDA 全家桶(2–3GB)
  • extras 内联进 --from "mflowy[modeling]"——uvx 的 --extra 需新版 uv
  • 入口名 mcpSrv 刻意避开 mcp SDK 同名 CLI(mcp.cli:app)——uvx 解析 mcp 命令可能命中 SDK 侧启动失败

分层

位置 职责
MCP Tools src/mflowy/mcp/tools.py 全部工具定义,纯委派
JobProvider src/mflowy/mcp/job_provider/ 执行策略(Local 直调 / Remote K8s Job)
Driver src/mflowy/driver/ YAML 解析、DAG 调度、handler 派发、模块发现
Compute src/mflowy/compute/ 业务逻辑

工具三分:建模类 4 种(modeling / explanation / predict / inverse_optimization)经 JobProvider 委派;分析类 3 种(data_profile / eda / infer_task_type_by_statistic)与 info/mlflow 组始终本地执行。

  • 零手工注册:compute 模块入口函数加 @handler(StepType.X, ...) 即完成注册(driver/discover.py 启动扫描 mflowy.compute.**_ 前缀与 _EXCLUDED 词干除外)
  • 通道边界print(stdout)= 业务数据,per-task 捕获进 NodeResult.outputlogger(stderr)= 过程诊断。同一信息只走一条通道
  • 模块内相对导入,跨模块绝对导入;KISS
  • tests/ 镜像 src/mflowy/ 路径,integration/ 端到端

Read the full file on GitHub · 93 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 93 lines · 1,856 tokens per session scan A 3d207689a10c

Subscribe to this mod's changes

mflowy AGENTS.md is an instructions file published in the GitHub repository ifoodsci-ai/mflowy (0 stars, last pushed 5d ago), licensed MIT. It adds 1,856 tokens to every session, about $0.0093 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.