Skip to content

troubleshooting.md

Latest commit

 

History

History
208 lines (142 loc) · 3.38 KB

troubleshooting.md

File metadata and controls

208 lines (142 loc) · 3.38 KB

Troubleshooting Setup Issues

✅ Quick Fixes

Issue: npm install fails with "react-flow-renderer" error

Solution: The package was renamed. It's now @xyflow/react.

The package.json has been updated. Run:

cd frontend
npm install --legacy-peer-deps

Or use the fallback setup:

.\setup_fallback.bat

Issue: Python script errors with "AttributeError: 'Namespace' object has no attribute 'reload'"

Solution: This was fixed by adding the missing --reload argument.

Run again:

.\setup_auto.ps1

Or manually generate the .env:

cd backend
python scripts\generate_env.py

Issue: npm install fails with peer dependencies error

Solution: Use legacy peer deps mode:

cd frontend
npm install --legacy-peer-deps

Issue: PostgreSQL not running

Solution:

# Start PostgreSQL service
net start postgresql

# Or check if it's installed
where psql

If not installed, download from: https://www.postgresql.org/download/windows/

Issue: Redis not running

Solution:

# Start Redis service
net start Redis

# Or check if installed
where redis-cli

If not installed, download from: https://github.com/microsoftarchive/redis/releases

🔧 Manual Setup (If Automated Fails)

Step 1: Create Backend .env

Create backend\.env with:

APP_ENV=development
APP_DEBUG=true
APP_URL=http://localhost:8000
SECRET_KEY=dev-secret-key-change-in-production
DATABASE_URL=postgresql://document_user:document_pass@localhost:5432/document_analyzer
REDIS_URL=redis://localhost:6379
ENCRYPTION_KEY=c2VjcmV0LWtleS1mb3ItZGV2ZWxvcG1lbnQtb25seQ==
JWT_SECRET_KEY=dev-jwt-secret-change-in-production
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GROQ_API_KEY=

Step 2: Create Frontend .env.local

Create frontend\.env.local with:

NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WS_URL=ws://localhost:8000
NEXT_PUBLIC_ENABLE_WEBSOCKET=true

Step 3: Install Dependencies

# Backend
cd backend
poetry install

# Frontend
cd frontend
npm install --legacy-peer-deps

Step 4: Run Migrations

cd backend
poetry run alembic upgrade head

🆘 Use Fallback Setup

If the main setup fails, use the fallback:

.\setup_fallback.bat

This script:

  • Creates .env files manually
  • Handles errors gracefully
  • Provides clear instructions
  • Works even if services are missing

📋 Verify Setup

After setup, verify:

# Check .env exists
test-path backend\.env
test-path frontend\.env.local

# Check dependencies
cd backend
poetry show

cd ..\frontend
npm list --depth=0

🎯 Start the Application

# Terminal 1 - Backend
cd backend
poetry run uvicorn app.main:app --reload

# Terminal 2 - Frontend
cd frontend
npm run dev

Access:

📚 More Help

Still having issues? Check the logs:

# Backend logs
cd backend
poetry run uvicorn app.main:app --reload --log-level debug

# Frontend logs
cd frontend
npm run dev -- --debug