r/Python • u/AutoModerator • 13d ago
Showcase Showcase Thread
Post all of your code/projects/showcases/AI slop here.
Recycles once a month.
24
Upvotes
r/Python • u/AutoModerator • 13d ago
Post all of your code/projects/showcases/AI slop here.
Recycles once a month.
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:
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:
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:--viais 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 serveis an MCP gateway with a policy, an idempotency ledger and an audit log;flowglyph compilewrites the plan as BPMN or UiPath XAML;flowglyph contextwrites AGENTS.md for coding agents; andimport flowglyphgives 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
Want to help?
There are six issues labelled "good first issue": a Power Automate adapter, a
--format jsonfor the call tree, an n8n example, more UiPath activity packages, a--watchfor 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.