File size: 1,899 Bytes
f083f90
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
---

title: Architecture Evaluator LLM
emoji: 🏗️
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
---


# Architecture Evaluator LLM

An AI-powered system design architecture evaluator using **Groq's FREE ultra-fast inference** with advanced reasoning models.

## Features

- 🚀 **FREE** - Uses Groq's free API (no costs!)
-**FAST** - Groq provides blazing-fast inference
- 🧠 **Smart** - DeepSeek R1 reasoning model for deep analysis
- Evaluates system design architectures based on multiple heuristics
- Provides detailed suggestions and recommendations
- Returns structured JSON responses
- Easy to integrate with any frontend

## API Endpoints

### POST /evaluate
Evaluates a system architecture.

**Request Body:**
```json

{

  "question": "Your question or context about the architecture",

  "architecture": {

    // Your architecture JSON with components and links

  }

}

```

**Response:**
```json

{

  "heuristic_scores": {

    "DURABILITY": 8.5,

    "AVAILABILITY": 9.0,

    "ENERGY_EFFICIENCY": 7.5,

    "CONSISTENCY": 8.0,

    "MAINTAINABILITY": 7.0,

    "LATENCY": 8.5,

    "COST": 6.5,

    "SECURITY": 8.0,

    "THROUGHPUT": 8.5,

    "SCALABILITY": 9.0

  },

  "suggestion": "Your architecture shows strong scalability..."

}

```

## Environment Variables

- `GROQ_API_KEY`: Your Groq API key (required - get free at https://console.groq.com)
- `MODEL_NAME`: Model to use (default: deepseek-r1-distill-llama-70b)
  - Available models:
    - `deepseek-r1-distill-llama-70b` - Best reasoning (default)
    - `llama-3.3-70b-versatile` - Great all-rounder
    - `llama-3.1-70b-versatile` - Fast and capable

## Getting Your Free Groq API Key

1. Go to https://console.groq.com
2. Sign up for a free account
3. Navigate to API Keys section
4. Create a new API key
5. Copy and use it (completely FREE!)