File size: 1,317 Bytes
d1ef64f
 
dda1f70
d1ef64f
dda1f70
d1ef64f
 
 
 
 
dda1f70
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
---
title: Vulnerability Scanner Api
emoji: πŸ”’
colorFrom: blue
colorTo: red
sdk: docker
pinned: false
license: mit
---

# Vulnerability Scanner API

AI-powered security vulnerability scanner for GitHub repositories and files.

## Features

- πŸ” Single file vulnerability scanning
- πŸ“¦ Full repository scanning (up to 15 files)
- πŸ€– Powered by Groq LLaMA 3.3 70B
- πŸš€ Fast and accurate security analysis
- πŸ“Š Detailed vulnerability reports with severity levels

## API Endpoints

### Health Check
```bash
GET /api/health
```

### Scan GitHub File or Repository
```bash
POST /api/scan
Content-Type: application/json

{
  "url": "https://github.com/owner/repo/blob/main/file.py"
}
```

Or scan entire repository:
```bash
{
  "url": "https://github.com/owner/repo"
}
```

## Environment Variables

- `GROQ_API_KEY` - Required for AI analysis
- `GITHUB_TOKEN` - Optional, for private repos and higher rate limits

## Usage

Test the API:
```bash
curl -X POST https://adityadevx-vulnerability-scanner-api.hf.space/api/scan \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/owner/repo/blob/main/file.py"}'
```

## Response Format

```json
{
  "result": "# Security Analysis Report\n\n## Vulnerabilities Found\n..."
}
```

Or in case of error:
```json
{
  "error": "Error message"
}
```