readme_2.md

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:

   pip install -r requirements.txt
   

3. Ensure data file exists: Place SAOKE_technologies.xlsx in the same directory

Usage

Web Application (Recommended)

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

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