Metadata-Version: 2.4
Name: postman-agent
Version: 1.0.5
Summary: AI Agent that auto-generates Postman Collections from backend code
Author-email: "M. Abubakar" <m.abubakar.codes@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Abubakar-webmaker/postman-ai-agent
Project-URL: Repository, https://github.com/Abubakar-webmaker/postman-ai-agent
Keywords: postman,api,ai,agent,langgraph,groq,express,fastapi,flask
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: langchain>=0.2.0
Requires-Dist: langchain-groq>=0.1.0
Requires-Dist: langgraph>=0.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# 🤖 Postman Collection AI Agent

> AI-powered tool that automatically analyzes your backend code and generates + imports Postman Collections — in seconds!

[![PyPI version](https://badge.fury.io/py/postman-agent.svg)](https://pypi.org/project/postman-agent/)
[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/abubakaranas921.postman-collection-ai-agent)](https://marketplace.visualstudio.com/items?itemName=abubakaranas921.postman-collection-ai-agent)
[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)

---

## ✨ What It Does

Paste your backend code → AI analyzes it → Postman Collection auto-imported! 🚀

---

## 🚀 3 Ways To Use

### 1️⃣ VS Code Extension (Easiest!)

Search "Postman Collection AI Agent" in VS Code Extensions
Right click any .js/.ts/.py file → Generate Postman Collection

### 2️⃣ CLI Tool
```bash
pip install postman-agent
postman-agent setup
postman-agent generate --scan .
```

### 3️⃣ Web UI
```bash
# Clone & run
git clone https://github.com/Abubakar-webmaker/postman-ai-agent
cd postman-ai-agent/frontend
npm install && npm run dev
```

---

## 🎯 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
- 💬 **Chat Panel** — Beautiful VS Code chat interface
- 🌐 **Multi-Framework** — Express.js, FastAPI, Flask, Django, Fastify
- ⚡ **Fast** — Analyzes entire project in seconds

---

## 🛠️ Tech Stack

| Layer | Technology |
|-------|------------|
| 🧠 Agent Framework | LangGraph |
| 🤖 LLM | Groq (llama-3.1-8b-instant) |
| 🔧 Code Parser | Python AST + Regex |
| 🔗 Integration | Postman REST API |
| 🐍 Backend | Python + FastAPI |
| 🎨 Frontend | React + TypeScript + Tailwind |
| 🔌 VS Code | TypeScript Extension |

---

## 🔄 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!

---

## 📋 Supported Frameworks

| Framework | Language | Status |
|-----------|----------|--------|
| Express.js | JavaScript | ✅ |
| Fastify | JavaScript | ✅ |
| FastAPI | Python | ✅ |
| Flask | Python | ✅ |
| Django | Python | ✅ |

---

## 📦 Requirements

- Python 3.10+
- Groq API Key (Free at [console.groq.com](https://console.groq.com))
- Postman API Key (Free at [postman.com](https://postman.com))

---

## 🔗 Links

- 📦 **PyPI:** [pypi.org/project/postman-agent](https://pypi.org/project/postman-agent/)
- 🔌 **VS Code:** [Postman Collection AI Agent](https://marketplace.visualstudio.com/items?itemName=abubakaranas921.postman-collection-ai-agent)
- 💼 **GitHub:** [Abubakar-webmaker](https://github.com/Abubakar-webmaker)
- 🌐 **Portfolio:** [abubakar-portfolio-sage.vercel.app](https://abubakar-portfolio-sage.vercel.app)

---

## 👨‍💻 Author

**M. Abubakar** — Full Stack Developer & AI Agent Builder

📧 m.abubakar.codes@gmail.com

---

## 📄 License

MIT License — feel free to use and modify!

---

⭐ **If this helped you, please give it a star!**

