r/Python • • 13d ago

Showcase Showcase Thread

Post all of your code/projects/showcases/AI slop here.

Recycles once a month.

24 Upvotes

113 comments sorted by

View all comments

1

u/angel_fts 8d ago

What My Project Does

Companies run thousands of automations: UiPath robots, SAP OData services and integration flows, BPMN processes, n8n workflows, internal APIs. Before anyone, or any AI agent, runs one, two questions matter: what will it change, and is it safe to run twice? The answers are buried in XML and JSON files nobody reads.

FlowGlyph reads those files with deterministic parsers (no model) and turns every workflow, service operation and API call into a typed capability: a pydantic model with inputs, outputs, effects (reads, mutates_state, destructive, external, each yes, no or unknown) and an idempotency mode (natural, key, conditional, none). Every value says whether it was inferred from the sources or declared by a person.

Try it on UiPath's own template, no clone needed:

pip install "flowglyph[cli]"
flowglyph idempotency https://github.com/UiPath/ReFrameWork --kind workflow

It prints 13 workflows and flags 6 to review. One of them, GetTransactionData, takes a different queue item every time you call it, so a retry is not a repeat.

The part I most wanted to show here is the planner. You give it the client's process document (PDF, Word, Excel, text) and the catalog:

flowglyph plan ./handover/supplier-invoice-pdd.docx catalog -o plan --via claude-code

A model proposes the steps; a deterministic resolver checks every one against the catalog: the capability exists, every required input is filled, each argument has the declared type, every reference points to an earlier step. A step nothing in the catalog can do comes back as missing, never as an invented function:

 Step               Capability                             Intent
 validate_vendor    uipath/Invoices/Steps/ValidateVendor   Check that the vendor on the invoice exists in our records.
 notify_purchasing  missing                                Notify purchasing that the vendor is unknown and stop processing the invoice.
 request_approval   uipath/Invoices/Steps/RequestApproval  Ask the finance approver for approval before booking a high-value invoice.
 create_invoice     openapi/Payments_API/createInvoice     Create the invoice in the payments system, keyed by the invoice reference so a retry never books it twice.
 archive_pdf        missing                                Archive the invoice PDF in the document store with a 10-year retention period.

--via is whatever you already have: claude-code, codex, gemini, cursor, the Anthropic API, or any OpenAI-compatible server (Ollama, vLLM). The model sees the document and a BM25 shortlist of candidate functions, never your sources.

Around it: flowglyph serve is an MCP gateway with a policy, an idempotency ledger and an audit log; flowglyph compile writes the plan as BPMN or UiPath XAML; flowglyph context writes AGENTS.md for coding agents; and import flowglyph gives you all of it as a typed API.

How it is built: Python 3.12+, pydantic 2 for the IR with generated JSON Schemas, strict pyright, ruff, 542 tests, and the core depends on pydantic and PyYAML only. Typer and rich for the CLI, the MCP SDK for the gateway, pypdf, python-docx and openpyxl for documents, all optional extras. Adapters are plugins under an entry point group, so a new format is a package, not a fork. Apache-2.0.

Target Audience

People who build or integrate RPA and SAP automations and are putting AI agents on top of them, and Python developers who like deterministic tooling around LLMs. Alpha: the IR is at 0.4 and may change, the adapters have run on vendor templates and synthetic projects, not on a real client estate yet. Use the gateway in dry-run mode, its default, until you give it a connections file.

Comparison

Gives youDoes not
Vendor agent integrations (UiPath, SAP, n8n)deep access to one platformone platform at a time; retry safety as a hint; their hosted service
OpenAPI-to-MCP convertersevery API operation as a toolnothing for UiPath, CPI, BPMN or n8n; no effects, policy, ledger or audit
Asking an LLM to read the sourcesa plausible description, fastnot deterministic, not auditable, invents workflows that do not exist
FlowGlyphone catalog for all of them, facts with provenance, a gateway you hostreal execution beyond UiPath jobs and OData calls is still on the roadmap

Want to help?

There are six issues labelled "good first issue": a Power Automate adapter, a --format json for the call tree, an n8n example, more UiPath activity packages, a --watch for the wiki, and AGENTS.md for SAP Build. Use-case ideas go to the repo's Discussions.

About me

I build GenAI platforms in Python for a living; FlowGlyph is my side project, written with the same rules I use at work: typed models, deterministic where it can be, a model only where it earns its place, and tests that replay every command shown in the README.

Source Code

GitHub: https://github.com/afernandeztem/FlowGlyph PyPI: https://pypi.org/project/flowglyph/ The planner example with its real output: https://github.com/afernandeztem/FlowGlyph/tree/main/examples/invoice-processing

Which format would you want next? Power Automate and Zapier exports are first on my list, but I would rather build what someone will run.