Skip to content

fix: improve start_ui.sh compatibility for Linux environments#169

Open
derhally wants to merge 1 commit intoAutoForgeAI:masterfrom
derhally:fix/start-ui-sh-compatibility-168
Open

fix: improve start_ui.sh compatibility for Linux environments#169
derhally wants to merge 1 commit intoAutoForgeAI:masterfrom
derhally:fix/start-ui-sh-compatibility-168

Conversation

@derhally
Copy link
Contributor

@derhally derhally commented Feb 7, 2026

Fixes #168

Summary

This PR addresses several compatibility issues in start_ui.sh that prevented it from working correctly in certain Linux environments.

Changes

  • ✅ Auto-detect package manager with preference order: uv > pip3 > pip
  • ✅ Use detected $PYTHON_CMD variable consistently throughout script
  • ✅ Check for Python 3.11+ requirement before proceeding
  • ✅ Try multiple Python commands in order: python3.13, python3.12, python3.11, python3, python
  • ✅ Use portable shebang: #!/usr/bin/env bash
  • ✅ Add set -e for better error handling
  • ✅ Improve error messages and diagnostics
  • ✅ Use exec for final Python invocation

Testing

  • Tested on Linux with uv and python3
  • Verified script works with systems that only have pip3 or uv available
  • Confirmed proper Python version detection

Files Changed

  • start_ui.sh

Fixes AutoForgeAI#168

This commit addresses several compatibility issues in start_ui.sh:

- Auto-detect package manager (uv > pip3 > pip) for broader compatibility
- Use detected $PYTHON_CMD variable consistently throughout script
- Add Python 3.11+ version requirement check
- Try multiple Python commands in priority order
- Use portable shebang (#!/usr/bin/env bash)
- Add set -e for better error handling
- Improve error messages and diagnostics
- Use exec for final Python invocation

The script now works correctly on systems with only pip3 or uv available,
and properly detects and uses the correct Python version.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@derhally derhally marked this pull request as ready for review February 7, 2026 10:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

start_ui.sh compatibility issues in Linux environments that use uv/pip3

1 participant