{"id":42722164,"url":"https://github.com/testy-cool/workflow-use","last_synced_at":"2026-01-29T16:13:49.448Z","repository":{"id":329403920,"uuid":"1113992149","full_name":"testy-cool/workflow-use","owner":"testy-cool","description":"⚙️ Create and run workflows (RPA 2.0)","archived":false,"fork":false,"pushed_at":"2025-12-19T21:21:12.000Z","size":3261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-22T03:35:07.923Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://browser-use.com","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/testy-cool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-10T18:39:52.000Z","updated_at":"2025-12-19T09:57:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/testy-cool/workflow-use","commit_stats":null,"previous_names":["testy-cool/workflow-use"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/testy-cool/workflow-use","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fworkflow-use","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fworkflow-use/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fworkflow-use/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fworkflow-use/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testy-cool","download_url":"https://codeload.github.com/testy-cool/workflow-use/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fworkflow-use/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28880972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T10:31:27.438Z","status":"ssl_error","status_checked_at":"2026-01-29T10:31:01.017Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-29T16:13:49.379Z","updated_at":"2026-01-29T16:13:49.439Z","avatar_url":"https://github.com/testy-cool.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cpicture\u003e\n  \u003cimg alt=\"Workflow Use logo - a product by Browser Use.\" src=\"./static/workflow-use.png\"  width=\"full\"\u003e\n\u003c/picture\u003e\n\n\u003cbr /\u003e\n\n\u003ch1 align=\"center\"\u003eDeterministic, Self Healing Workflows (RPA 2.0)\u003c/h1\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/browser-use/workflow-use?style=social)](https://github.com/browser-use/workflow-use/stargazers)\n[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://link.browser-use.com/discord)\n[![Cloud](https://img.shields.io/badge/Cloud-☁️-blue)](https://cloud.browser-use.com)\n[![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/gregpr07)\n[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/mamagnus00)\n\n⚙️ **Workflow Use** is the easiest way to create and execute deterministic workflows with variables which fallback to [Browser Use](https://github.com/browser-use/browser-use) if a step fails. You just _show_ the recorder the workflow, we automatically generate the workflow.\n\n❗ This project is in very early development so we don't recommend using this in production. Lots of things will change and we don't have a release schedule yet. Originally, the project was born out of customer demand to make Browser Use more reliable and deterministic.\n\n## 🚀 NEW: Generation Mode\n\nAutomatically generate workflows from natural language! Describe your task, we run browser-use once, then create a reusable semantic workflow stored in a database.\n\n### Quick Commands\n\n```bash\n# Generate workflow from task description\npython cli.py generate-workflow \"Find GitHub stars for browser-use repo\"\n\n# List all workflows\npython cli.py list-workflows\n\n# Filter by generation mode\npython cli.py list-workflows --generation-mode browser_use\n\n# Run stored workflow\npython cli.py run-stored-workflow \u003cworkflow-id\u003e --prompt \"Find stars for playwright repo\"\n\n# View workflow details\npython cli.py workflow-info \u003cworkflow-id\u003e\n\n# Delete workflow\npython cli.py delete-workflow \u003cworkflow-id\u003e\n```\n\n### How It Works\n\n1. **Describe**: Give a task in natural language\n2. **Execute**: Browser-use completes the task once\n3. **Generate**: Execution history → semantic workflow with parameters\n4. **Store**: Save to database with metadata\n5. **Reuse**: Run the workflow with different inputs, no AI needed\n\n### Advanced Options\n\n```bash\n# Custom models for generation\npython cli.py generate-workflow \"Your task\" \\\n  --agent-model \"gpt-4.1-mini\" \\\n  --extraction-model \"gpt-4.1-mini\" \\\n  --workflow-model \"gpt-4o\"\n\n# Use Browser-Use Cloud browser\npython cli.py generate-workflow \"Your task\" --use-cloud\n\n# Save to custom location\npython cli.py generate-workflow \"Your task\" --output-file ./my-workflow.json\n\n# Skip database storage\npython cli.py generate-workflow \"Your task\" --no-save-to-storage\n```\n\n### Storage\n\nWorkflows stored at `workflows/storage/`:\n- `metadata.json` - Searchable index of all workflows\n- `workflows/\u003cid\u003e.workflow.json` - Individual workflow files\n\n### Programmatic Usage\n\n```python\nfrom workflow_use.healing.service import HealingService\nfrom workflow_use.storage.service import WorkflowStorageService\nfrom browser_use.llm import ChatOpenAI\n\nhealing_service = HealingService(llm=ChatOpenAI(model='gpt-4.1'))\nstorage_service = WorkflowStorageService()\n\n# Generate workflow\nworkflow = await healing_service.generate_workflow_from_prompt(\n    prompt=\"Fill contact form on example.com\",\n    agent_llm=ChatOpenAI(model='gpt-4.1-mini'),\n    extraction_llm=ChatOpenAI(model='gpt-4.1-mini'),\n    use_cloud=True  # Optional: use Browser-Use Cloud\n)\n\n# Save to storage\nmetadata = storage_service.save_workflow(\n    workflow=workflow,\n    generation_mode='browser_use',\n    original_task=\"Fill contact form on example.com\"\n)\n\n# Retrieve and execute\nloaded_workflow = storage_service.get_workflow(metadata.id)\n```\n\n# Quick start\n\n```bash\ngit clone https://github.com/browser-use/workflow-use\n```\n\n## Build the extension\n\n```bash\ncd extension \u0026\u0026 npm install \u0026\u0026 npm run build\n```\n\n## Setup workflow environment\n\n```bash\ncd .. \u0026\u0026 cd workflows\nuv sync\nsource .venv/bin/activate # for mac / linux\nplaywright install chromium\ncp .env.example .env # add your OPENAI_API_KEY to the .env file\n```\n\n\n## Run workflow as tool\n\n```bash\npython cli.py run-as-tool examples/example.workflow.json --prompt \"fill the form with example data\"\n```\n\n## Run workflow with predefined variables\n\n```bash\npython cli.py run-workflow examples/example.workflow.json\n```\n\n## Record your own workflow\n\n```bash\npython cli.py create-workflow\n```\n\n## See all commands\n\n```bash\npython cli.py --help\n```\n\n# Usage from python\n\nRunning the workflow files is as simple as:\n\n```python\nfrom workflow_use import Workflow\n\nworkflow = Workflow.load_from_file(\"example.workflow.json\")\nresult = asyncio.run(workflow.run_as_tool(\"I want to search for 'workflow use'\"))\n```\n\n## Cloud Browser Support\n\nRun workflows in [Browser-Use Cloud](https://cloud.browser-use.com) (new signups get $10 free credits via OAuth or $1 via email) with semantic abstraction (no AI):\n(NOTE: Set BROWSER_USE_API_KEY environment variable)\n```python\nfrom workflow_use import Workflow\n\nworkflow = Workflow.load_from_file(\"workflow.json\", llm, use_cloud=True)\nresult = await workflow.run_with_no_ai()  # No LLM calls, uses semantic mapping\n```\n\nExamples:\n- `examples/cloud_browser_demo.py` - Load recorded workflow and run on cloud\n\n## Launch the GUI\n\nThe Workflow UI provides a visual interface for managing, viewing, and executing workflows.\n\n### Option 1: Using the CLI command (Recommended)\n\nThe easiest way to start the GUI is with the built-in CLI command:\n\n```bash\ncd workflows\npython cli.py launch-gui\n```\n\nThis command will:\n- Start the backend server (FastAPI)\n- Start the frontend development server\n- Automatically open http://localhost:5173 in your browser\n- Capture logs to the `./tmp/logs` directory\n\nPress Ctrl+C to stop both servers when you're done.\n\n### Option 2: Start servers separately\n\nAlternatively, you can start the servers individually:\n\n#### Start the backend server\n\n```bash\ncd workflows\nuvicorn backend.api:app --reload\n```\n\n#### Start the frontend development server\n\n```bash\ncd ui\nnpm install\nnpm run dev\n```\n\nOnce both servers are running, you can access the Workflow GUI at http://localhost:5173 in your browser. The UI allows you to:\n\n- Visualize workflows as interactive graphs\n- Execute workflows with custom input parameters\n- Monitor workflow execution logs in real-time\n- Edit workflow metadata and details\n\n# Demos\n\n## Workflow Use filling out form instantly\n\nhttps://github.com/user-attachments/assets/cf284e08-8c8c-484a-820a-02c507de11d4\n\n## Gregor's explanation\n\nhttps://github.com/user-attachments/assets/379e57c7-f03e-4eb9-8184-521377d5c0f9\n\n# Features\n\n- 🔁 **Record Once, Reuse Forever**: Record browser interactions once and replay them indefinitely.\n- ⏳ **Show, don't prompt**: No need to spend hours prompting Browser Use to do the same thing over and over again.\n- ⚙️ **Structured \u0026 Executable Workflows**: Converts recordings into deterministic, fast, and reliable workflows which automatically extract variables from forms.\n- 🪄 **Human-like Interaction Understanding**: Intelligently filters noise from recordings to create meaningful workflows.\n- 🔒 **Enterprise-Ready Foundation**: Built for future scalability with features like self-healing and workflow diffs.\n\n# Vision and roadmap\n\nShow computer what it needs to do once, and it will do it over and over again without any human intervention.\n\n## Workflows\n\n- [ ] Nice way to use the `.json` files inside python code\n- [ ] Improve LLM fallback when step fails (currently really bad)\n- [ ] Self healing, if it fails automatically agent kicks in and updates the workflow file\n- [ ] Better support for LLM steps\n- [ ] Take output from previous steps and use it as input for next steps\n- [ ] Expose workflows as MCP tools\n- [ ] Use Browser Use to automatically create workflows from websites\n\n## Developer experience\n\n- [ ] Improve CLI\n- [ ] Improve extension\n- [ ] Step editor\n\n## Agent\n\n- [ ] Allow Browser Use to use the workflows as MCP tools\n- [ ] Use workflows as website caching layer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesty-cool%2Fworkflow-use","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftesty-cool%2Fworkflow-use","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesty-cool%2Fworkflow-use/lists"}