Skip to content

Commit 7163c7f

Browse files
committed
Add sample env
1 parent 336fa27 commit 7163c7f

File tree

7 files changed

+82
-199
lines changed

7 files changed

+82
-199
lines changed

README.md

Lines changed: 63 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,63 @@
1-
API Testing Tool made with AI
1+
## OpenAPI Testing Tool
2+
3+
Automatically generate comprehensive API test cases from your OpenAPI specification using a local Ollama model. This tool simplifies API validation, reduces manual effort, and integrates seamlessly into your development workflow.
4+
5+
For learning more about OpenAPI Specifications: https://spec.openapis.org/oas/v3.1.0.html#openapi-specification
6+
7+
### Features
8+
9+
- **OpenAPI Integration** - Parses your API specification to understand endpoints and schemas.
10+
- **Local Ollama Model** - Uses a locally hosted LLM for generating intelligent test cases.
11+
- **Automated Test Generation** - Quickly produces unit/integration tests for endpoints.
12+
- **User Friendly Interface** - View the snapshots of the application below
13+
- **Fast & Secure** - No external API calls; all processing happens locally.
14+
15+
### Prequisities
16+
17+
- Node.js `v22.12.0` or higher (Important)
18+
- npm or yarn
19+
- Ollama installed locally (https://ollama.com/download)
20+
- Your OpenAPI specification file (`openapi.yaml` or .json)
21+
22+
## 🛠 Installation Steps
23+
24+
1. Clone the Repository
25+
26+
```shell
27+
git clone git@github.com:eddyseed/OpenAPI-Testing-Tool.git
28+
cd OpenAPI-Testing-Tool/
29+
```
30+
31+
2. Install Dependencies (For both Frontend & Backend)
32+
33+
```shell
34+
npm install
35+
```
36+
37+
3. Verify Ollama Installation
38+
39+
```shell
40+
ollama list
41+
```
42+
43+
Ensure your desired model (e.g., `phi3:mini`) is available.
44+
45+
4. Edit your `.env.sample` in `backend/`
46+
```env
47+
# All variables should be changed according to the development requirements.
48+
49+
PORT=3000
50+
NODE_ENV=development
51+
52+
LOCAL_HOST=http://localhost:3000
53+
CORS_ORIGIN=http://localhost:5173
54+
OLLAMA_HOST=http://localhost:11434
55+
56+
#Set your own local model name
57+
MODEL_NAME=your_model_name
58+
```
59+
> For getting a list of all models do `ollama list`
60+
61+
## Screenshots
62+
63+

backend/.env.sample

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# All variables should be changed according to the development requirements.
2+
3+
PORT=3000
4+
NODE_ENV=development
5+
6+
LOCAL_HOST=http://localhost:3000
7+
CORS_ORIGIN=http://localhost:5173
8+
OLLAMA_HOST=http://localhost:11434
9+
10+
#Set your own local model name
11+
MODEL_NAME=your_model_name
12+
13+
#For getting a list of all models do `ollama list`

backend/package-lock.json

Lines changed: 1 addition & 190 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

backend/package.json

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,24 +14,19 @@
1414
"license": "ISC",
1515
"description": "",
1616
"dependencies": {
17-
"@tanstack/react-table": "^8.21.3",
18-
"@xterm/xterm": "^5.5.0",
1917
"axios": "^1.11.0",
20-
"bcryptjs": "^3.0.2",
2118
"chokidar": "^4.0.3",
2219
"cors": "^2.8.5",
2320
"dotenv": "^17.2.1",
2421
"express": "^5.1.0",
2522
"helmet": "^8.1.0",
2623
"js-yaml": "^4.1.0",
2724
"jsonrepair": "^3.13.0",
28-
"jsonwebtoken": "^9.0.2",
2925
"multer": "^2.0.2",
3026
"socket.io": "^4.8.1",
3127
"tail": "^2.2.6",
3228
"winston": "^3.17.0",
3329
"ws": "^8.18.3",
34-
"xterm": "^5.3.0",
3530
"zod": "^4.1.5"
3631
},
3732
"devDependencies": {

0 commit comments

Comments
 (0)