https://github.com/dharshan-kumarj/pingstream
Pingstream is a lightweight, Streamlit-based API testing tool using curl under the hood. Designed for low-RAM systems, it supports GET, POST, PUT, DELETE with JSON, headers, file uploads, and Postman/OpenAPI import.
https://github.com/dharshan-kumarj/pingstream
api-testing-tool curl developer-tools json lightweight linux-tools low-memory openapi postman-alternative productivity python python3 rest-api streamlit
Last synced: about 1 month ago
JSON representation
Pingstream is a lightweight, Streamlit-based API testing tool using curl under the hood. Designed for low-RAM systems, it supports GET, POST, PUT, DELETE with JSON, headers, file uploads, and Postman/OpenAPI import.
- Host: GitHub
- URL: https://github.com/dharshan-kumarj/pingstream
- Owner: dharshan-kumarj
- Created: 2025-04-13T08:41:23.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-03T14:01:55.000Z (8 months ago)
- Last Synced: 2025-06-04T00:01:06.284Z (8 months ago)
- Topics: api-testing-tool, curl, developer-tools, json, lightweight, linux-tools, low-memory, openapi, postman-alternative, productivity, python, python3, rest-api, streamlit
- Language: Python
- Homepage:
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 Pingstream — The Lightweight API Tester
**Pingstream** is a minimalist, memory-efficient GUI tool for testing REST APIs. Built using Python, Streamlit, and `curl`, it’s perfect for developers working in low-resource environments (like 4GB RAM machines) where heavy tools like Postman just don't cut it.
---
## 🔧 Features
* ⚡ **Lightweight** – Ideal for systems with limited RAM
* 🔄 **Core HTTP Methods** – GET, POST, PUT, DELETE
* 🧱 **Request Builder** – Build complete API calls with ease
* 🧩 **Header Manager** – Add, edit, and remove custom headers
* 🧮 **Query Parameter Support** – Clean interface for managing query params
* 📦 **JSON Body Editor** – Includes automatic JSON validation
* 📁 **File Upload** – Send files with your API requests
* 🕓 **Request History** – View your recent API calls
* 🌀 **Curl-based Engine** – Reliable, fast request handling
* 📤 **Import/Export** – Supports Postman collections and OpenAPI JSON files
---
## 📥 Installation
### ✅ Prerequisites
* Python 3.7+
* `pip`
* `curl` (should be installed and accessible in your system PATH)
### 🛠 Setup
```bash
# Clone or download this repo
git clone https://github.com/yourusername/pingstream.git
cd pingstream
# Install dependencies
pip install streamlit
# Run the app
streamlit run pingstream.py
```
---
## 🚀 Usage Guide
### 🔹 Make a Request
1. Select HTTP method (GET, POST, etc.)
2. Enter the API URL
3. Click "Send Request"
### 🔹 Manage Headers
* Go to the "Headers" tab
* Add key-value pairs
* Click "Add Header" as needed
### 🔹 Add Query Params
* Go to the "Params" tab
* Add key-value pairs
* Click "Add Parameter"
### 🔹 Send JSON Body
* Go to the "Body" tab
* Choose “raw JSON”
* Paste your JSON (automatic validation included)
### 🔹 Upload Files
* Go to the "Files" tab
* Use the uploader to include your file in the request
### 🔹 Import/Export
* Import API definitions from Postman or OpenAPI JSON
* Export your requests for reuse or sharing
---
## 🧰 Troubleshooting
### ⚠ ScriptRunContext Warnings
If you see warnings like `missing ScriptRunContext`, you can suppress them with:
```bash
streamlit run pingstream.py --logger.level=error
```
Or create a config file:
```toml
# .streamlit/config.toml
[logger]
level = "error"
```
### ❌ Request Errors
* Confirm `curl` is installed: `curl --version`
* Check your internet and API endpoint
* Validate your JSON structure
---
## 🧾 Requirements
* Python 3.7+
* Streamlit
* curl
---
## 👨💻 Created By
**Pingstream** was developed by [@dharshan-kumarj](https://github.com/dharshan-kumarj) on April 13, 2025, with love for developers using low-end machines.
**UI Enhancements by** [@ronnie-allen](https://github.com/ronnie-allen) — improving the design and experience of the Streamlit interface.
> 💡 Built on Linux, powered by `curl`, and designed to work even when your RAM says “no”.
---