{"id":50733303,"url":"https://github.com/theprojectsx/postman_automate","last_synced_at":"2026-06-10T11:01:16.103Z","repository":{"id":349699687,"uuid":"1203504344","full_name":"TheProjectsX/postman_automate","owner":"TheProjectsX","description":"An AI Automated runner to test postman collections. Simple agentic workflow to validated, create, execute requests.","archived":false,"fork":false,"pushed_at":"2026-04-18T10:57:36.000Z","size":189,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T12:32:48.548Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheProjectsX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-04-07T05:14:25.000Z","updated_at":"2026-04-09T09:26:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TheProjectsX/postman_automate","commit_stats":null,"previous_names":["theprojectsx/postman_automate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheProjectsX/postman_automate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheProjectsX%2Fpostman_automate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheProjectsX%2Fpostman_automate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheProjectsX%2Fpostman_automate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheProjectsX%2Fpostman_automate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheProjectsX","download_url":"https://codeload.github.com/TheProjectsX/postman_automate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheProjectsX%2Fpostman_automate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34149132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-06-10T11:01:15.144Z","updated_at":"2026-06-10T11:01:16.090Z","avatar_url":"https://github.com/TheProjectsX.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postman AI Automator\n\n**Status:** Beta v1\n\n![Demo](./assets/demo.png)\n\nA small CLI that turns a Postman Collection into a step-by-step JSON workflow (REGISTER / INPUT / LOG / EXECUTE), using Gemini to plan the flow and then execute it. It also saves generated workflows for reuse and writes detailed logs while it runs.\n\nCurrently it is in Beta test version. Many more things there is to be fixed. And I will continue to work on this.\n\n**Flow (what / where / why / how)**\n\n- What: Convert a Postman Collection into an ordered JSON workflow of actions (REGISTER, INPUT, LOG, EXECUTE).\n- Where: Input is your `collection.json`; output is stored in `workflows/` with run logs in `logs/process_logs/`.\n- Why: Enforces consistent API execution order and variable handling, even for complex collections.\n- How: Parses and simplifies the collection, sends a structured prompt to Gemini, validates the JSON response, then optionally executes each step.\n\n**Quick start**\n\n1. Create `.env` with `GEMINI_API_KEY`.\n2. Run:\n\n```bash\nnode index.ts \u003cpostman-collection\u003e.json\n\n# With workflow\nnode index.ts \u003cpostman-collection\u003e.json --workflow workflows/workflow_2026-04-07_10-28-17.json\n```\n\n**Outputs**\n\n- Generated workflows are saved under `workflows/`.\n    \u003e AI generated workflow is saved so that it can be used later w/o calling AI for same request paths. Tokens saved!\n- Run logs are written under `logs/process_logs/`.\n    \u003e No thing is missed, every action, every response, every request is logged here to debug later\n- Run errors are written under `logs/error_logs`.\n    \u003e If a route faces error, detailed response with request is saved to check and debug later\n- Response saved postman collections exported under `exports/`.\n    \u003e The requests and responses of the executions are saved in the postman collection to import in postman and use it!\n\n**Flags**\n\n```bash\n--delay=\u003cms\u003e         Delay between requests (default: 0)\n--timeout=\u003cms\u003e       Request timeout in ms (default: 30000)\n--skip=\u003cpattern\u003e     Skip requests whose URL contains pattern\n--only=\u003cpattern\u003e     Only run requests whose URL contains pattern\n--workflow=\u003cpath\u003e    Use a pre-generated workflow JSON (alias: -wf=)\n--context=\u003ctext\u003e     Extra AI instructions (alias: -c=)\n--dry                Dry run - plan workflow but do not send requests\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheprojectsx%2Fpostman_automate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheprojectsx%2Fpostman_automate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheprojectsx%2Fpostman_automate/lists"}