SolaraViz Cannot Be Run Locally - Multiple Installation and Execution Failures

[ashfaq92]

Problem

SolaraViz cannot be run in local Python scripts despite following official documentation. Only works in Jupyter notebooks, which is inadequate for most ABM development workflows.

Environment

• Python version: 3.13.5
• Mesa version: 3.2.0
• OS: Windows 11
• Installation method: pip

Current Issues Preventing Local Development:

1. solara.run() method doesn't exist in current API
2. solara.server.run() method doesn't exist
3. page.run() fails with "AttributeError: 'Element' object has no attribute 'run'"
4. Command line solara run filename.py fails with various import errors
5. Official documentation examples don't work for local scripts

Steps to Reproduce

folowed code https://mesa.readthedocs.io/latest/tutorials/6_visualization_custom.html but in the end, instead of page tried several hacks but was unable to visualize.

[tpike3]

@ashfaq92 Thanks for bringing this to our attention. Can you confirm the version of Mesa and Solara that you are running.

[EwoutH]

@ashfaq92 can you also give some more details about your development environment? For example with PyCharm and the latest version of Mesa, I can’t reproduce 4.

1 (and 2) are related to #2176 (comment) I think.

I do understand your frustration though.

[qfa-ok]

import errors (3) could be related to a lack of environment setup. just to confirm.

[joelgraff]

Came across this thread as I encountered the page.run() error when called at the end of the python script. Followed the link in the comment by @EwoutH and tried calling "solara run app.py" from the terminal. This worked as it should.

Running Windows 10, Python 3.13.2, Mesa 3.2.0, numpy 2.2.3, pandas 2.2.3, scipy 1.15.2, VSCode environment

[tpike3]

Came across this thread as I encountered the page.run() error when called at the end of the python script. Followed the link in the comment by @EwoutH and tried calling "solara run app.py" from the terminal. This worked as it should.

Running Windows 10, Python 3.13.2, Mesa 3.2.0, numpy 2.2.3, pandas 2.2.3, scipy 1.15.2, VSCode environment

Thanks for the feedback @joelgraff, glad it is working