uri2flow

uri2flow v0.1

AI Cost Tracking

• 🤖 LLM usage: $0.4135 (4 commits)
• 👤 Human dev: ~$268 (2.7h @ $100/h, 30min dedup)

Generated on 2026-06-15 using openrouter/qwen/qwen3-coder-next

---

uri2flow is a small compiler for compact URI flows.

It converts human/LLM-friendly YAML:

flow:
  id: weather-agent-local-health

do:
  - agent://weather-generator
  - hypervisor://local/weather-agent/run
  - browser://chrome/page/open:
      url: http://localhost:8101/health

into an expanded workflow_graph manifest for uri3.

Why this exists

Full workflow YAML is useful for machines, debugging and audit, but it is too verbose for humans and LLMs. The preferred input format should be URI-first and compact. uri2flow handles the expansion step.

Role in the system

nl2uri    -> natural language -> compact URI flow / URI graph
uri2flow  -> compact URI flow -> expanded workflow graph
uri3      -> validate, plan, route and execute graph
uri2ops   -> execute UI/OS/browser operations
hypervisor -> lifecycle, deployment, policy, registry

Install

pip install -e .

Commands

uri2flow validate examples/15_compact_uri_flow/weather.uri.flow.yaml
uri2flow expand examples/15_compact_uri_flow/weather.uri.flow.yaml --out output/weather.uri.graph.yaml
uri2flow print examples/15_compact_uri_flow/weather.uri.flow.yaml

Example

See examples/15_compact_uri_flow.

Design rule

uri2flow does not execute anything. It only parses, normalizes and expands compact URI flows.

Links

• TODO · CHANGELOG
• nl2uri · uri3
• Org status: ../TODO_STATUS.md

License

Licensed under Apache-2.0.