File size: 3,411 Bytes
498ac5c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# SAOKE Problem Solver

A modern web application that transforms technical problems into solutions using the SAOKE methodology (Subject-Action-Object-Knowledge-Effect).

## Overview

This application analyzes technical problems, extracts relevant effects, matches them with proven mechanisms from a patent database, and generates comprehensive solutions following the SAOKE framework.

## Features

### 🎨 Modern Web Interface
- Beautiful, responsive Streamlit-based UI
- Step-by-step guided workflow
- Progress tracking and visual indicators
- Real-time processing feedback

### πŸ”¬ Advanced Analysis
- AI-powered effect extraction using Google Gemini
- Semantic similarity matching with sentence transformers
- Patent-based mechanism retrieval
- Structured solution generation

### πŸš€ User-Friendly Workflow
1. **Problem Input** - Enter your technical challenge
2. **Effects Extraction** - AI extracts key effects (with regeneration)
3. **Mechanism Matching** - Maps effects to proven technologies
4. **Solution Generation** - Creates comprehensive solution (with regeneration)

## Installation

1. **Clone or download** the application files
2. **Install dependencies:**
   ```bash
   pip install -r requirements.txt
   ```
3. **Ensure data file exists:** Place `SAOKE_technologies.xlsx` in the same directory

## Usage

### Web Application (Recommended)
```bash
python run_saoke_web_app.py
```
- Opens automatically in your browser at `http://localhost:8501`
- Modern, intuitive interface
- Real-time progress tracking

### Legacy Tkinter Application
```bash
python run_saoke_app_tkinter_backup.py
```
- Desktop GUI application
- Tabbed interface
- Basic functionality

## Requirements

- Python 3.8+
- Internet connection (for AI services)
- `SAOKE_technologies.xlsx` data file
- Required Python packages (see `requirements.txt`)

## Key Technologies

- **Streamlit** - Modern web interface
- **Google Gemini** - AI-powered text analysis
- **Sentence Transformers** - Semantic similarity matching
- **Pandas** - Data processing
- **NumPy** - Numerical computations

## File Structure

```
β”œβ”€β”€ saoke_web_app.py              # Main web application
β”œβ”€β”€ run_saoke_web_app.py          # Web app launcher
β”œβ”€β”€ saoke_app_tkinter_backup.py   # Legacy Tkinter app
β”œβ”€β”€ run_saoke_app_tkinter_backup.py # Legacy launcher
β”œβ”€β”€ requirements.txt              # Python dependencies
β”œβ”€β”€ SAOKE_technologies.xlsx       # Patent mechanisms database
└── README.md                     # This file
```

## Example Workflow

1. **Enter Problem:** "I want to send a private message to my friend over the network"

2. **Effects Extracted:**
   - Message Confidentiality Assurance
   - Recipient-Exclusive Message Decryption

3. **Mechanisms Matched:**
   - On-the-Fly Encryption/Decryption
   - Asymmetric Encryption

4. **Solution Generated:**
   - Structured implementation plan
   - Functional and non-functional requirements
   - Step-by-step SAOKE breakdown

## API Configuration

The application uses a hardcoded Gemini API key. For production use, consider:
- Environment variables for API keys
- User authentication
- Rate limiting
- Error handling improvements

## Support

For issues or questions:
1. Check that all requirements are installed
2. Verify `SAOKE_technologies.xlsx` exists
3. Ensure internet connectivity for AI services
4. Review console output for error messages