Reflex requires Python 3.8+.
We highly recommend creating a virtual environment for your project.
venv is the standard option. conda and poetry are some alternatives.
We will go with venv here.
macOS (Apple Silicon) users should 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.
mkdir my_app_name cd my_app_name
python3 -m venv .venv source .venv/bin/activate
Reflex is available as a pip package.
pip install reflex
For Windows users, we recommend using Windows Subsystem for Linux (WSL) for optimal performance.
WSL users should refer to instructions for Linux above.
For the rest of this section we will work with native Windows (non-WSL).
We will go with venv here, for virtual environments.
mkdir my_app_name cd my_app_name
py -3 -m venv .venv .venv\\Scripts\\activate
pip install reflex
reflex init
The command will return four template options to choose from as shown below.
Initializing the web directory. Get started with a template: (0) blank (https://blank-template.reflex.run) - A minimal template (1) dashboard (https://dashboard.reflex.run) - A dashboard with tables and graphs (2) chat (https://chat.reflex.run) - A ChatGPT clone (3) sidebar (https://sidebar-template.reflex.run) - A template with a sidebar to navigate pages Which template would you like to use? (0):
From here select a template.
It is also possible to initialize your project based on a git repo. This is possible with any app in our gallery.
Run the command:
reflex init --template \{app_url}
Where a real example would look like this:
reflex init --template https://github.com/pynecone-io/pynecone-examples/tree/main/dalle
Run it in development mode:
reflex run
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 run --loglevel debug
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.
The demo app showcases some of Reflex's features.
reflex demo