Add Ralph Orchestrator dependency documentation and improved installation

Added comprehensive Ralph Orchestrator integration documentation:

1. requirements.txt
   - ralph-orchestrator (core dependency for /ralph command)
   - pyyaml (for config parsing)
   - Comments explaining each dependency

2. Updated supercharge.sh
   - Enhanced Ralph installation with dual detection:
     * Checks for 'ralph' command in PATH
     * Checks for ralph_orchestrator Python package
   - Installs from requirements.txt if available
   - Falls back to direct pip install
   - Provides helpful error messages with installation instructions
   - Confirms successful installation with detailed status

3. Updated README.md with new section "Ralph Orchestrator"
   - What is Ralph Orchestrator and how it works
   - Installation methods (automatic, manual, system-wide)
   - Detailed breakdown of our Ralph integration:
     * bin/ralphloop wrapper script (6,290 bytes, 223 lines)
     * skills/ralph/ Claude Code skill
     * skills/brainstorming/ multi-AI integration
     * hooks/ralph-auto-trigger.sh automatic triggering
     * hooks/qwen-consult.sh Qwen AI consultation
   - File structure created by Ralph
   - Environment variables reference
   - Troubleshooting guide
   - Ralph Orchestrator source links

The /ralph command will now work properly on:
- This machine (ralph already installed)
- Fresh clones (supercharge.sh auto-installs ralph-orchestrator)
- Any machine with pip3 available

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
uroma
2026-01-23 18:28:00 +00:00
Unverified
parent 932529d37f
commit cd5c39811d
3 changed files with 249 additions and 4 deletions

19
requirements.txt Normal file
View File

@@ -0,0 +1,19 @@
# Python Dependencies for SuperCharged Claude Code
# Install with: pip install -r requirements.txt
# Core: Ralph Orchestrator - Autonomous "Tackle Until Solved" agent loop
# Used by: /ralph command, ralphloop wrapper, autonomous iteration
ralph-orchestrator>=0.1.0
# Optional: YAML parsing for ralph configuration
# Used by: ralphloop script, agent sync scripts
pyyaml>=6.0
# Optional: jq alternative for JSON parsing in Python
# Used by: Some hooks and scripts that need JSON manipulation
# Install if you don't have jq installed: apt-get install jq
# Development dependencies (optional)
# pytest>=7.0
# black>=23.0
# mypy>=1.0