Troubleshooting

Troubleshooting Dependencies

While setting up Peeps AI is designed to be straightforward, you might encounter issues related to dependencies or environment configurations. This guide provides detailed solutions to common problems, ensuring a smooth installation process.

---

❖ Python Version Issues

Problem: Peeps AI requires Python version >=3.10 and <3.13, but your system has a different version installed.

Solution:

⟐ Check your Python version:

python --version

⟐ If an incompatible version is detected, download and install the correct version from the official Python website.

⟐ If you have multiple Python versions installed, specify the correct one when running commands:

python3.10 -m venv venv

⟐ Update the PATH environment variable to point to the correct Python installation.

---

❖ Missing or Outdated pip

Problem: pip is missing or outdated, causing dependency installation to fail.

Solution:

⟐ Upgrade pip to the latest version:

python -m pip install --upgrade pip

⟐ If pip is not found, reinstall it using:

python -m ensurepip --upgrade

---

❖ Dependency Build Errors

Problem: Errors occur while building certain dependencies, such as tiktoken or numpy.

Solution:

⟐ Install a Rust Compiler Some dependencies require Rust to compile. Install Rust using:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

For Windows, use the Rust Installer.

⟐ Ensure Compatible Build Tools

• On Windows: Install Visual C++ Build Tools from Microsoft's website.

• On Linux: Ensure build-essential is installed:

  sudo apt-get install build-essential

• On macOS: Install Xcode Command Line Tools:

  xcode-select --install

⟐ Retry installing dependencies:

pip install -r requirements.txt

⟐ If the issue persists, use pre-built wheels:

pip install <package_name> --prefer-binary

---

❖ Virtual Environment Problems

Problem: Issues arise when activating or using a virtual environment.

Solution:

⟐ Ensure the virtual environment is activated before running any commands:

• On Unix/Linux/macOS:

  source venv/bin/activate

• On Windows:

  venv\Scripts\activate

⟐ If activation fails, recreate the virtual environment:

python -m venv venv

⟐ Confirm that the virtual environment’s python is being used:

which python

The output should point to the virtual environment directory.

---

❖ Version Conflicts

Problem: Conflicting versions of dependencies cause errors during installation.

Solution:

⟐ Check installed versions of conflicting packages:

pip list

⟐ Manually upgrade or downgrade packages as needed:

pip install <package_name>==<desired_version>

⟐ To ensure a clean installation, uninstall problematic packages:

pip uninstall <package_name>

⟐ Reinstall dependencies:

pip install -r requirements.txt

---

❖ Git Clone or Repository Issues

Problem: Errors occur when cloning the PeepsAI repository.

Solution:

⟐ Verify that Git is installed and accessible:

git --version

If Git is not installed, download it from here.

⟐ Ensure the repository URL is correct:

git clone https://github.com/peepsai/peepsai.git

⟐ If cloning fails, check your internet connection or try a different directory with write permissions.

⟐ If you suspect corruption in the cloned repository, delete the directory and clone again:

rm -rf peepsai
git clone https://github.com/peepsai/peepsai.git

---

❖ Common Errors and Fixes

---

❖ Getting Help

If you’ve tried the above solutions and are still facing issues, you can:

• Check the Peeps AI GitHub Issues for similar problems and fixes.

• Join the Peeps AI community forums for support and discussions.

• Contact the Peeps AI support team via email or Slack (details in the README).