Reflex requires Python 3.10+.

We highly recommend creating a virtual environment for your project.

uv is the recommended modern option. venv, conda and poetry are some alternatives.

We will go with uv here.

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

Replace my_app_name with your project name. Switch to 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.

From here select an option.

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.

Built with Reflex