Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
202 lines (140 loc) · 3.96 KB

TROUBLESHOOTING.md

File metadata and controls

202 lines (140 loc) · 3.96 KB

🚨 Setup Troubleshooting Guide

Last Updated: When you fix the network issue Created: December 21, 2024

The SDK is ready - we just need to get dependencies installed!

  1. docs/getting_started.md - Learn the API
  2. examples/ - Review the code
  3. PHASE1_COMPLETE.md - What's built
  4. INDEX.md - Project overview

While waiting for internet/setup:

💡 Meanwhile: Read the Docs

  1. Let us know your macOS version: sw_vers
  2. Share the output of: which python3
  3. Share the output of: python3 --version If none of these work, please:

📞 Contact Support

curl -I https://pypi.org
ping google.com
```bash
### Check Network

python3 -m pip list python3 -m pip --version

### Check pip

python3 -m venv --help python3 --version which python3

### Check Python Installation

## 🆘 Still Having Issues?

---

python3 examples/basic_agent.py export PYTHONPATH="${PYTHONPATH}:$(pwd)" cd /Users/n0r0bhn/Documents/flowllm-python

2. **Run with Python path:**

- The packages listed in `requirements.txt`
- Python 3.9+
1. **Ensure these packages are available:**

If you want to use the SDK **right now** without any package manager:

## 📦 Alternative: Manual Dependency Installation

---

python examples/basic_agent.py poetry shell

Add your OPENAI_API_KEY to .env

cp .env.example .env

4. **Set up and run**

poetry install cd /Users/n0r0bhn/Documents/flowllm-python

3. **Install FlowLLM**

export PATH="/Users/n0r0bhn/.local/bin:$PATH" curl -sSL https://install.python-poetry.org | python3 -

2. **Install Poetry**

brew install python@3.11

1. **Install Homebrew Python** (most reliable)

**When you have internet access:**

## 🎯 Recommended Path Forward

---

open INDEX.md

Read documentation

cat examples/basic_agent.py

View examples

ls -la flowllm/

Check structure

cd /Users/n0r0bhn/Documents/flowllm-python

To verify the code works without installing dependencies:

## ✅ Quick Test (No Installation)

---

3. Or use cached/offline packages
2. Try again when connected
1. Check your internet connection
**Fix:**

**Cause:** No internet connection or DNS issues.

**Error:** `[Errno 8] nodename nor servname provided, or not known`

## 📋 Current Network Issue

---

docker run -it --env-file .env flowllm python examples/basic_agent.py docker build -t flowllm .

Create Dockerfile (already provided below)

### Option 4: Use Docker

python examples/basic_agent.py

Run examples

pip install -r requirements.txt cd /Users/n0r0bhn/Documents/flowllm-python

Install dependencies

conda activate flowllm conda create -n flowllm python=3.11

Create environment

bash Miniconda3-latest-MacOSX-x86_64.sh curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh

Install miniconda

### Option 3: Use conda/miniconda

python3 examples/basic_agent.py

Run examples directly

Edit .env and add your API keys

cp .env.example .env

Set up environment

python3 -m pip install --user -r requirements.txt python3 -m pip install --user --upgrade pip

Install dependencies to user directory

cd /Users/n0r0bhn/Documents/flowllm-python

### Option 2: Use pip with User Install (No Poetry)

curl -sSL https://install.python-poetry.org | python3 -

Now try Poetry again

python3 --version

Verify installation

brew install python@3.11

Install Python via Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Homebrew (if not installed)

### Option 1: Install Homebrew Python (Recommended)

## 🔧 Solution Options

---

**Cause:** Your Python installation (from CommandLineTools) has a limitation that prevents creating virtual environments without symlinks.

**Error:** `Exception: This build of python cannot create venvs without using symlinks`

## Issue: Poetry Installation Failed