Uninstall and Troubleshooting¶

Uninstalling BeeAI¶

Complete Uninstall¶

To completely remove BeeAI from your system, follow the "Uninstall" section in the BeeAI documentation installation guide depending on how you installed BeeAI.

Getting Help¶

CLI Documentation¶

You can access comprehensive CLI documentation directly from your terminal:

View all available commands:
```
beeai --help
```

Get help for specific commands:

beeai platform --help
beeai env --help
beeai ui --help

Common Issues and Solutions¶

Port Conflicts¶

Problem: "Port already in use" error when starting agents

Solution:

Check what's running on the port:
```
lsof -i :8000
```
Kill the process if needed, substituting the number in the "PID" column:
```
kill -9 <PID>
```

Or use a different port:

uv run src/ticket_workflow_agent.py --port 8001

BeeAI Platform Won't Start¶

Problem: beeai platform start fails

Solutions:

Try stopping and restarting:

beeai platform delete
beeai platform start

API Key Issues¶

Problem: Authentication errors or "Invalid API key"

Solutions:

Reconfigure your LLM provider:
```
beeai env setup
```
Verify your API key is correctly set in the environment
Check that your API key has sufficient credits/quota

Python/UV Issues¶

Problem: uv sync fails or Python dependency errors

Solutions:

Try clearing uv cache:
```
uv cache clean
```
Reinstall dependencies:
```
uv sync --reinstall
```

Browser Issues¶

Problem: BeeAI UI doesn't load in browser

Solutions:

Upgrade BeeAI to the latest version
Run this command, which will check the platform and env:
```
beeai ui
```

Recreate your BeeAI platform instance and try again:

beeai platform delete
beeai platform start
beeai ui

Workshop Files Missing¶

Problem: Can't find workshop files or folders

Solutions:

Ensure you cloned the correct repository:

git clone https://github.com/IBM/beeai-workshop.git

Navigate to the correct directory:
```
cd beeai-workshop/intro_acp_beeai
```
Verify the files exist:
```
ls -la src/
```

Reset and Clean Installation¶

If you're experiencing persistent issues, try a clean reinstall -- follow the "Uninstall" section and then the "Install" section in the BeeAI installation documentation.

Getting Additional Support¶

If you continue to experience issues:

Check the BeeAI documentation
Review the GitHub repository for known issues
Ensure all prerequisites from the pre-work section are met

Tip

When reporting issues, include the output of beeai --version and your operating system information to help with troubleshooting.