{"id":20493201,"url":"https://github.com/exios66/ai-interaction-scripts","last_synced_at":"2026-02-23T20:19:28.413Z","repository":{"id":262345310,"uuid":"886099003","full_name":"Exios66/Ai-Interaction-Scripts","owner":"Exios66","description":"Interaction Scripts for the Literary Vault focused Research.","archived":false,"fork":false,"pushed_at":"2024-12-14T11:13:48.000Z","size":211,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T05:55:35.256Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://exios66.github.io/Ai-Interaction-Scripts/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Exios66.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-10T07:28:08.000Z","updated_at":"2024-12-18T20:52:22.000Z","dependencies_parsed_at":"2024-11-12T00:18:17.147Z","dependency_job_id":"99684d0d-773b-4658-8786-902582922f09","html_url":"https://github.com/Exios66/Ai-Interaction-Scripts","commit_stats":null,"previous_names":["exios66/ai-interaction-scripts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FAi-Interaction-Scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FAi-Interaction-Scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FAi-Interaction-Scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exios66%2FAi-Interaction-Scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Exios66","download_url":"https://codeload.github.com/Exios66/Ai-Interaction-Scripts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242074763,"owners_count":20068112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T17:33:32.666Z","updated_at":"2026-02-23T20:19:28.328Z","avatar_url":"https://github.com/Exios66.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Interaction Scripts Repository\n\n## 📋 Overview\n\nA comprehensive collection of AI interaction and analysis tools, focusing on psychological clustering and open-ended response analysis. This repository provides tools for analyzing survey responses, performing psychological clustering, and processing qualitative data.\n\n## 🚀 Key Features\n\n### Open-Ended Response Analysis\n\n- Process and analyze survey responses\n- Automated coding of qualitative data\n- Theme identification and analysis\n- Verification step quantification\n- Statistical summaries and reporting\n\n### Psychological Clustering\n\n- Advanced clustering algorithms\n- Pattern recognition\n- Data visualization\n- Statistical analysis\n\n### Core Capabilities\n\n- CSV data import/export\n- Natural Language Processing\n- Automated theme detection\n- Statistical analysis\n- Comprehensive logging and debugging\n- GUI interfaces for data selection\n\n## 📁 Repository Structure\n\n```bash\nAI-Interaction-Scripts/\n├── scripts/\n│   ├── README.md                 # Detailed script documentation\n│   ├── __init__.py              # Package initialization\n│   ├── polyPsych/               # Psychological analysis modules\n│   │   ├── clustering.py        # Clustering algorithms\n│   │   └── open_end.py         # Open-ended response analysis\n│   └── utils/                   # Utility modules\n│       ├── __init__.py         # Utils initialization\n│       ├── debug_utils.py      # Debugging utilities\n│       └── logging_config.py   # Logging configuration\n├── logs/                        # Log file directory\n│   ├── analysis_*.log          # Analysis logs\n│   └── debug_*.log            # Debug logs\n├── debug_logs/                  # Detailed debug information\n├── requirements.txt            # Project dependencies\n├── setup.py                    # NLTK setup script\n├── run.py                      # Main execution script\n└── README.md                   # This file\n```\n\n## 🔧 Installation\n\n### Prerequisites\n\n- Python 3.7 or higher\n- pip package manager\n- Virtual environment (recommended)\n\n### Setup Steps\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/yourusername/AI-Interaction-Scripts.git\ncd AI-Interaction-Scripts\n```\n\n2. Create and activate virtual environment:\n\n```bash\npython -m venv venv\n\n# Windows\n.\\venv\\Scripts\\activate\n\n# macOS/Linux\nsource venv/bin/activate\n```\n\n3. Install dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n4. Run NLTK setup:\n\n```bash\npython setup.py\n```\n\n## 💻 Usage\n\n### Running the Analysis Tool\n\n1. Start the analysis tool:\n\n```bash\npython run.py\n```\n\n2. Choose from available options:\n   - Load and analyze CSV responses\n   - Run example analysis\n   - View debug logs\n   - Exit\n\n### Data Requirements\n\n#### CSV Format for Response Analysis\n\n```csv\nID,Definition,VerificationSteps\n1,\"Response text...\",\"Verification steps...\"\n```\n\n### Analysis Features\n\n1. **Response Coding**\n   - Automated categorization\n   - Theme identification\n   - Frequency analysis\n\n2. **Verification Analysis**\n   - Step counting\n   - Statistical summaries\n   - Pattern identification\n\n3. **Theme Analysis**\n   - Keyword extraction\n   - Frequency analysis\n   - Pattern recognition\n\n## 🔍 Debugging and Logging\n\n### Log Files\n\n- Analysis logs: `logs/analysis_[timestamp].log`\n- Debug logs: `debug_logs/debug_[timestamp].log`\n- Error tracking: Comprehensive stack traces\n\n### Debug Levels\n\n- DEBUG: Detailed execution information\n- INFO: General operational messages\n- WARNING: Potential issues\n- ERROR: Operation failures\n- CRITICAL: System-critical issues\n\n## 🛠 Advanced Features\n\n### Custom Tokenization\n\n- NLTK-based processing\n- Fallback mechanisms\n- Custom sentence splitting\n\n### Statistical Analysis\n\n- Descriptive statistics\n- Frequency analysis\n- Pattern recognition\n- Clustering analysis\n\n## 📊 Output Formats\n\n### Analysis Results\n\n- Coded responses\n- Theme frequencies\n- Statistical summaries\n- Verification patterns\n\n### Export Options\n\n- CSV format\n- JSON data\n- Statistical reports\n- Debug logs\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n1. NLTK Data\n   - Run `setup.py`\n   - Check internet connection\n   - Verify data directory\n\n2. Data Loading\n   - Check CSV format\n   - Verify encoding (UTF-8)\n   - Column name matching\n\n3. System Resources\n   - Memory management\n   - Process optimization\n   - Resource allocation\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create feature branch\n3. Implement changes\n4. Submit pull request\n\n### Development Guidelines\n\n- Follow PEP 8 style guide\n- Add comprehensive documentation\n- Include unit tests\n- Update README as needed\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 📫 Support\n\n- Review documentation\n- Check debug logs\n- Submit issues\n- Contact maintainers\n\n## 🙏 Acknowledgments\n\n- NLTK Project\n- Python Data Science Community\n- Open Source Contributors\n\n---\n\nMade with ❤️ by [Your Name]\n\nFor detailed script-specific documentation, see [scripts/README.md](scripts/README.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexios66%2Fai-interaction-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexios66%2Fai-interaction-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexios66%2Fai-interaction-scripts/lists"}