Troubleshooting Guide:

Common Installation Issues

"orion command not found"

Solution:

# Check if Orion is in PATH
echo $PATH

# Use full path instead
python /path/to/orion/interpreter.py shell

# Or add to PATH manually
export PATH=$PATH:/path/to/orion

"Python not found"

Solution:

• Install Python 3.8+ from python.org
• Use python3 instead of python
• Ensure Python is added to PATH

Permission denied

Solution:

# Linux/macOS
chmod +x interpreter.py
chmod +x install.sh

# Windows: Run as Administrator

Runtime Errors

"Invalid expression"

Common causes:

• Missing quotes: message = Hello → message = "Hello"
• Wrong operators: result = 5 3 → result = 5 + 3
• Unmatched parentheses: result = (5 + 3 → result = (5 + 3)

"Function not found"

Solutions:

• Check spelling: lenght() → len()
• Define functions before using them
• Verify function is available in current scope

Type conversion errors

Solution:

# Validate input before converting
get age_str "Enter age: "
if isdigit(age_str):
    age = int(age_str)
else:
    display "Please enter a valid number"

Performance Issues

Slow execution

Solutions:

• Avoid nested loops when possible
• Use built-in functions: sum(numbers) instead of manual loops
• Clear large variables when done: clear(large_list)

Memory usage

Solutions:

• Avoid infinite loops
• Clear unused variables
• Use smaller data structures when possible

Platform-Specific Issues

Windows

• Add Orion to antivirus exclusions
• Use Command Prompt or PowerShell
• Avoid spaces in installation path

Linux/macOS

• Use python3 instead of python
• Install pip: sudo apt install python3-pip
• Check file permissions: ls -la interpreter.py

Getting Help

Built-in Commands

help     # Show help in interactive shell
about    # Display version information

Community Support

• GitHub Issues - Report bugs
• Discussions - Ask questions
• Wiki - Documentation

Error Reference

Error	Meaning	Solution
"Invalid expression"	Syntax error	Check operators and quotes
"Unknown function"	Function not found	Check spelling and definition
"Cannot divide by zero"	Division by zero	Check denominator
"Index out of range"	List index too large	Check list length

When reporting bugs, include:

• Orion version (about command)
• Operating system
• Complete error message
• Code that reproduces the issue