System requirements
FastrAPI requires Python 3.8 or higher. It’s built with Rust and PyO3, but you don’t need to install Rust separately as the package includes pre-compiled binaries.Minimum requirements:
- Python 3.8+
- pip or uv package manager
- 64-bit architecture (x86_64 or ARM64)
Installation methods
- uv (recommended)
- pip
uv is a fast Python package installer and resolver written in Rust.If you don’t have uv installed, you can install it with:
Dependencies
FastrAPI automatically installs the following dependencies:- fastapi >= 0.124.4 - For compatibility with FastAPI ecosystem
- pydantic >= 2.10.6 - For data validation and serialization
- httpx >= 0.28.1 - For HTTP client functionality
- pytest >= 8.3.5 - For testing support
Verifying installation
After installation, verify that FastrAPI is installed correctly by checking the version:Installation in virtual environments
It’s recommended to install FastrAPI in a virtual environment to avoid conflicts with other packages.Using venv
Using uv
Troubleshooting
ImportError: No module named 'fastrapi'
ImportError: No module named 'fastrapi'
This means FastrAPI is not installed in your current Python environment.Solution:
- Ensure you’re using the correct Python environment
- Reinstall FastrAPI:
pip install fastrapi - Check if your virtual environment is activated
Installation fails with compilation errors
Installation fails with compilation errors
FastrAPI includes pre-compiled binaries, so compilation should not be necessary.Solution:
- Ensure you’re using Python 3.8 or higher:
python --version - Update pip:
pip install --upgrade pip - Try installing with
--no-cache-dir:pip install --no-cache-dir fastrapi
Version conflicts with FastAPI
Version conflicts with FastAPI
FastrAPI includes fastapi as a dependency for compatibility.Solution:
- Let FastrAPI manage the fastapi dependency version
- If you need a specific fastapi version, install it after FastrAPI
- Check compatibility:
pip show fastrapi fastapi
Architecture not supported
Architecture not supported
FastrAPI provides pre-built wheels for common architectures.Solution:
- Ensure you’re on a 64-bit system
- Supported platforms: Linux (x86_64, ARM64), macOS (x86_64, ARM64), Windows (x86_64)
- For other architectures, you may need to build from source
Building from source
If you need to build FastrAPI from source (for development or unsupported architectures):Next steps
Quickstart
Build your first FastrAPI application
Migration guide
Migrate from FastAPI to FastrAPI