đźš§ Prototype Notice

This project (sufast) is currently a dummy prototype.
Only static routes are working at the moment.
Dynamic routing and full features are under development.
Thank you for understanding! 🙏

Sufast/Documentation
Troubleshooting

Troubleshooting Guide

Common issues and their solutions when working with Sufast applications.

Installation Issues
Common problems during Sufast installation

❌ Problem: pip install sufast fails

Installation fails with compilation errors or missing dependencies.

âś… Solutions:

Installation Fixesbash
# 1. Update pip and setuptools
pip install --upgrade pip setuptools wheel

# 2. Install with pre-compiled wheels
pip install --only-binary=all sufast

# 3. Use specific Python version
python3.11 -m pip install sufast

# 4. Install from source (if wheels unavailable)
pip install sufast --no-binary sufast

# 5. Clear pip cache
pip cache purge
pip install sufast

❌ Problem: ImportError: No module named 'sufast'

Python can't find the Sufast module after installation.

âś… Solutions:

Import Fixesbash
# 1. Check if sufast is installed
pip list | grep sufast

# 2. Verify Python environment
which python
python --version

# 3. Check installation location
python -c "import sys; print(sys.path)"

# 4. Reinstall in correct environment
pip uninstall sufast
pip install sufast

# 5. For virtual environments
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate  # Windows
pip install sufast

❌ Problem: Version conflicts with dependencies

Dependency conflicts with other packages in your environment.

âś… Solutions:

Dependency Fixesbash
# 1. Create fresh virtual environment
python -m venv fresh_env
source fresh_env/bin/activate
pip install sufast

# 2. Check for conflicts
pip check

# 3. Install with dependency resolver
pip install --upgrade-strategy eager sufast

# 4. Use requirements.txt with pinned versions
echo "sufast>=1.0.0" > requirements.txt
pip install -r requirements.txt

# 5. Force reinstall dependencies
pip install --force-reinstall sufast
Still Need Help?
Additional resources and support options

📚 Documentation

đź’¬ Community Support

  • • GitHub Issues for bug reports
  • • Discord community chat
  • • Stack Overflow (tag: sufast)
  • • Reddit r/sufast community