Installation
Reflex requires Python 3.10+.
Virtual Environment
We highly recommend creating a virtual environment for your project.
uv is the recommended modern option. venv, conda and poetry are some alternatives.
Install Reflex on your system
We will go with uv here.
Prerequisites
Install uv
After installation, restart your terminal or run source ~/.bashrc (or source ~/.zshrc for zsh).
Alternatively, install via Homebrew, PyPI, or other methods.
macOS (Apple Silicon) users: Install Rosetta 2. Run this command:
/usr/sbin/softwareupdate --install-rosetta --agree-to-license
Create the project directory
Replace {app_name} with your project name. Switch to the new directory.
Initialize uv project
Add Reflex to the project
Initialize the Reflex project
Running uv run reflex init will return the option to start with a blank Reflex app, premade templates built by the Reflex team, or to try our AI builder.
From here select an option.
Run the App
Run it in development mode:
Your app runs at http://localhost:3000.
Reflex prints logs to the terminal. To increase log verbosity to help with debugging, use the --loglevel flag:
Reflex will hot reload any code changes in real time when running in development mode. Your code edits will show up on http://localhost:3000 automatically.