🤖 Postman AI Agent
AI-powered CLI tool that automatically analyzes your backend code and generates + imports Postman Collections — in seconds!
✨ What It Does
Paste your backend code → AI analyzes it → Postman Collection auto-imported! 🚀
pip install postman-agent
postman-agent setup
postman-agent generate --scan .
🎯 Features
- 🔍 Smart Detection — Finds API files by content, not filename
- 🧠 AI-Powered — LangGraph ReAct Agent + Groq LLM
- 📦 Auto Import — Directly imports into your Postman workspace
- 🔗 Instant Link — Get Postman collection URL instantly
- 🌐 Multi-Framework — Express.js, FastAPI, Flask, Django, Fastify
- ⚡ Fast — Analyzes entire project in seconds
🚀 Quick Start
1. Install
pip install postman-agent
2. Setup API Keys (One time only)
postman-agent setup
You'll need:
3. Generate Collection
# Scan entire project
postman-agent generate --scan .
# Or single file
postman-agent generate --file routes.js
4. Open in Postman 🎉
✅ Found 33 routes!
🚀 Imported to Postman Successfully!
🔗 Open here: https://go.postman.co/collection/xxxxx
📋 Supported Frameworks
| Framework |
Language |
Status |
| Express.js |
JavaScript |
✅ |
| Fastify |
JavaScript |
✅ |
| FastAPI |
Python |
✅ |
| Flask |
Python |
✅ |
| Django |
Python |
✅ |
🛠️ Tech Stack
| Layer |
Technology |
| 🧠 Agent Framework |
LangGraph |
| 🤖 LLM |
Groq (llama-3.1-8b-instant) |
| 🔧 Code Parser |
Python AST + Regex |
| 🔗 Integration |
Postman REST API |
| 🐍 Language |
Python 3.10+ |
🔄 How It Works
Your Project
↓
🔍 Smart Scanner (content-based)
↓
🤖 LangGraph AI Agent
↓
🔧 AST + Regex Parser
↓
📦 Postman Collection v2.1
↓
🚀 Auto Import to Postman
↓
✅ Ready to Test!
💻 Demo
$ postman-agent generate --scan ./ecommerce-backend
╔═══════════════════════════════════════╗
║ 🤖 Postman AI Agent CLI ║
║ LangGraph + Groq + Postman API ║
╚═══════════════════════════════════════╝
🔍 Scanning directory: ./ecommerce-backend
📁 Found 15 API files:
→ app.js
→ authRoutes.js
→ productRoutes.js
→ orderRoutes.js
→ paymentRoutes.js
...
🔎 Detected Framework: Express.js
🤖 AI Agent analyzing code...
✅ Found 33 routes!
📋 Detected Routes:
POST /register
POST /login
GET /me
GET /products
POST /orders
POST /stripe/create-intent
...
🚀 ✅ Imported to Postman Successfully!
🔗 Open here: https://go.postman.co/collection/xxxxx
✨ Done! Happy Testing! 🎉
📦 Requirements
- Python 3.10+
- Groq API Key (Free)
- Postman API Key (Free)
🤝 Contributing
Pull requests are welcome! Feel free to open issues for bugs or feature requests.
👨💻 Author
M. Abubakar — Full Stack Developer & AI Agent Builder
📄 License
MIT License — feel free to use and modify!
⭐ If this helped you, please give it a star!
