Spaces:
Sleeping
Sleeping
| # 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 |