Installation
~3 minutes · Requires Python 3.10+.
Virtual Environment
We recommend uv as the default; venv, conda, and poetry are alternatives.
Install Reflex on your system
Install uv
After installation, restart your terminal or run source ~/.bashrc (or source ~/.zshrc for zsh).
Alternatively, install via Homebrew, PyPI, or other methods.
Set up the Reflex project
Replace <your-app> with your project name, then switch into the new directory.
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.
If this is your first time, pick (0) A blank Reflex app — the rest of the docs assume you started there.
Run the App
Run it in development mode:
Your app runs at http://localhost:3000. Reflex hot reloads any code changes in real time — your edits show up automatically.
For troubleshooting, increase log verbosity with the --loglevel flag: