Skip to content

Latest commit

History

128 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Projects Repository

A comprehensive collection of 24 diverse Python projects ranging from AI/LLM tools to automation utilities, games, and file management systems. This repository serves as a showcase of various programming concepts, AI integrations, and practical utilities developed with LLM assistance.

🎯 Repository Status & Key Findings

Overall Assessment: 2.3/5.0 current → 3.5-4.0/5.0 with 3-6 month investment

Top Commercial Opportunities

  1. ChatGPTArchive → "ConvoInsight" (Score: 4.1/5) - $50K-$200K revenue potential Year 1
  2. brainstorm/bookmaker → "ContentForge" (Score: 3.4/5) - $30K-$150K revenue potential Year 1
  3. allseeingeye → "CodeMapper" (Score: 3.4/5) - $15K-$60K revenue potential Year 1

Critical Actions Required

  • 🚨 SECURITY: Remove hardcoded API key in llmchatroom.py (CRITICAL)
  • 🚨 FUNCTIONALITY: Fix missing imports in ant.py, llmchatroom.py, allseeingeye.py (CRITICAL)
  • ⚠️TESTING: Implement test coverage (currently 0%, target 40%+)

📊 For detailed analysis, see EVALUATION_EXECUTIVE_SUMMARY.md

🚀 Quick Start

Prerequisites

  • Python 3.7 or higher
  • pip package manager

Basic Installation

# Clone the repository
git clone https://github.com/CrazyDubya/projects.git
cd projects
# Install common dependencies
pip install requests rich lxml
# For AI/LLM projects
pip install anthropic torch transformers
# For specific projects, see individual project directories

📋 Project Overview

This repository contains 24 projects organized into 4 main categories:

  • 🤖 AI & LLM Tools (9 projects) - Conversation analysis, multi-LLM interfaces, content generation
  • 🎮 Games & Simulations (3 projects) - Space simulation, quantum chess, rule-changing games
  • 🔧 Utilities & File Processors (8 projects) - Directory analysis, format converters, data processors
  • 🔄 System Automation (4 projects) - File management, monitoring, device interaction

Repository Statistics

  • Total Projects: 24
  • Python Files: 51
  • Lines of Code: 6,095
  • Average Project Size: 254 lines

🗂️ Project Categories

🤖 AI & Language Model Tools

ProjectDescriptionKey Features
ChatGPTArchiveConversation analysis suiteJSON parsing, word clouds, statistical analysis
llmchatroomMulti-LLM conversation facilitatorAPI integration, token tracking, conversation logs
hive-mindDistributed AI systemMulti-node architecture, coordination protocols
inner_monologueAI inner monologue managerGUI interface, memory management
antAnthropic API interfaceRich console output, conversation history
chatterLLM conversation bridgeDual LLM setup, model switching
chatroomMulti-user AI chatroomGUI interface, metrics tracking
brainstormContent generation toolAPI wrappers, content creation
bookmakerDocument generationBook creation, publishing workflows

🎮 Games & Simulations

ProjectDescriptionKey Features
4xSpace simulation gameColony management, diplomacy, tech trees, ship design
Quantum_ChessQuantum mechanics chessSuperposition, entanglement, tunneling moves
nomicRule-changing game engineDynamic rules, voting system, mixed human/AI players

🔧 Utilities & File Processors

ProjectDescriptionKey Features
allseeingeyeDirectory analysis toolRecursive traversal, visual trees, content analysis
jsonreaderJSON processing toolsData extraction, formatting, validation
xmlmergeXML file mergerMultiple file merging, order management
HeaderPyCode header generatorStandardized headers, template-based
MDtoHTMLMarkdown converterMarkdown to HTML conversion
MakeMarkdownText to Markdown converterAutomated formatting, batch processing

🔄 System Automation

ProjectDescriptionKey Features
iPhone toss to MacCross-device automationDirectory monitoring, script execution
moverFile movement utilityAutomatic file organization, monitoring
movelogLog file organizerDirectory cleanup, file categorization
bluetoothBluetooth device interactionDevice discovery, connection management

📖 Detailed Documentation

Repository Evaluation & Analysis

This repository includes comprehensive professional evaluation documentation (3,600+ lines) providing multi-dimensional analysis of all projects, commercial viability assessments, technical debt matrices, and actionable recommendations.

📊 Start Here - Quick Navigation

New to this repository? → Read EVALUATION_EXECUTIVE_SUMMARY.md (10 min overview)

Considering commercial development? → Read COMMERCIAL_VIABILITY_ASSESSMENT.md

Evaluating for investment/acquisition? → Read EVALUATION_EXECUTIVE_SUMMARY.md + TECHNICAL_DEBT_MATRIX.md

Want to use the evaluation framework? → Read MATRIX_REPORTS_EVALUATION.md

Need project details? → Read PROJECT_INDEX.md + INDEX.md

Complete Documentation Suite

DocumentPurposeAudienceLength
EVALUATION_EXECUTIVE_SUMMARY.mdHigh-level overview & key findingsAll audiences10 min
EVALUATION_COMMENTS_ANALYSIS.mdMeta-analysis of evaluation docsDocumentation team25 min
COMMERCIAL_VIABILITY_ASSESSMENT.md9 commercial matrices, financial projectionsInvestors, entrepreneurs35 min
TECHNICAL_DEBT_MATRIX.mdCode quality, security, remediationDevelopers, CTOs30 min
MATRIX_REPORTS_EVALUATION.mdEvaluation framework methodologyFramework users35 min
PROJECT_INDEX.mdDetailed project catalogDevelopers, users20 min
TECHNICAL_EVALUATION.mdInfrastructure & dependenciesDevOps, architects15 min
INDEX.mdQuick reference & scoringAll audiences8 min

Project Documentation

For comprehensive project details, see:

🏆 Featured Projects

Most Complex & Sophisticated

  1. 4x Space Simulation - Complete game ecosystem with 7 interconnected modules
  2. hive-mind - Distributed AI system with multi-node coordination
  3. Quantum_Chess - Innovative chess variant with quantum mechanics

Most Practical & Useful

  1. ChatGPTArchive - Essential tool for AI conversation analysis
  2. allseeingeye - Powerful directory analysis and visualization
  3. iPhone toss to Mac - Comprehensive automation suite

Highest Commercial Potential

  1. 4x - Game development platform
  2. hive-mind - Enterprise distributed computing
  3. ChatGPTArchive - AI workflow optimization tool

🛠️ Technology Stack

  • Primary Language: Python 3.7+
  • AI/ML Libraries: torch, transformers, anthropic
  • GUI Frameworks: tkinter, rich (console)
  • File Processing: json, xml, pathlib
  • Networking: requests, websockets
  • Platform Support: Cross-platform (Unix/Linux optimized)

📁 Repository Structure

projects/
├── .github/ # GitHub workflows and templates
├── 4x/ # Space simulation game suite
├── ChatGPTArchive/ # Conversation analysis tools
├── HeaderPy/ # Code header utilities
├── MDtoHTML/ # Markdown conversion tools
├── MakeMarkdown/ # Text to Markdown converters
├── Quantum_Chess/ # Quantum chess implementation
├── allseeingeye/ # Directory analysis tools
├── ant/ # Anthropic API interface
├── bluetooth/ # Bluetooth communication
├── bookmaker/ # Document generation
├── brainstorm/ # Content creation tools
├── chatroom/ # Multi-user chat system
├── chatter/ # LLM conversation bridge
├── hive-mind/ # Distributed AI system
├── iPhone toss to Mac/ # Cross-device automation
├── inner_monologue/ # AI monologue manager
├── jsonreader/ # JSON processing utilities
├── llmchatroom/ # Multi-LLM facilitator
├── movelog/ # Log organization
├── mover/ # File movement automation
├── noder/ # Node communication system
├── nomic/ # Rule-changing game
├── pi/ # Raspberry Pi projects
├── xmlmerge/ # XML merging utilities
├── INDEX.md # Technical project index
├── PROJECT_INDEX.md # Comprehensive project analysis
├── LICENSE # MIT License
└── README.md # This file

🤝 Contributing

We welcome contributions to any of the projects in this repository! Please see CONTRIBUTING.md for detailed guidelines.

Quick Contribution Guide

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes and test thoroughly
  4. Commit your changes (git commit -m 'Add amazing feature')
  5. Push to the branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

Development Guidelines

  • Follow existing code style and patterns
  • Add documentation for new features
  • Include tests where applicable
  • Respect the MIT License terms
  • See individual project READMEs for specific requirements

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links & Resources

📊 Project Metrics

MetricValue
Total Projects24
Python Files51
Total LOC6,095
AI/LLM Projects9 (37.5%)
Utility Projects8 (33.3%)
Game Projects3 (12.5%)
Automation Projects4 (16.7%)

This repository represents a diverse collection of Python projects developed with LLM assistance, showcasing various programming concepts, AI integrations, and practical utilities. Each project is designed as a standalone utility while contributing to the overall learning and development ecosystem.

About

Variety of LLM assisted projects.

Topics

Resources

Code of conduct

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages