Since updating to 3.5.2, app fails to load.

[samkahn-prog]

I see this in my browser:

and this error from the app:
Doza Assist server failed to start after setup.

Last lines of log:

File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 1536, in call
return self.wsgi_app(environ, start_response)
~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 1514, in wsgi_app
response = self.handle_exception(e)
File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 860, in handle_exception
server_error = self.ensure_sync(handler)(server_error)
File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 512, in _handle_provider_error
from ai_providers import ProviderError
ModuleNotFoundError: No module named 'ai_providers'

• Serving Flask app 'app'
• Debug mode: off
  �[31m�[1mWARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.�[0m
• Running on http://127.0.0.1:5050
  �[33mPress CTRL+C to quit�[0m

Full log: /Users/samkahn/Library/Application Support/DozaAssist/server.log

M1 Ultra, 128 GB RAM
MacOS 26.5
Doza: 3.5.2

[DozaVisuals]

Hey @samkahn-prog — thanks for the report. The ModuleNotFoundError: No module named 'ai_providers' you're seeing isn't actually the root cause; it's a secondary error from the global error handler that masked whatever the real exception was. So the message you got is misleading, and we owe you a clearer one.

I just shipped v3.5.3 which fixes the masking. After updating, if the underlying issue is still there, server.log will now show the real exception instead of the secondary one — which gives us something actionable to debug.

Please try this:

1. Download the new DMG from https://github.com/DozaVisuals/doza-assist/releases/tag/v3.5.3 and replace your existing install.
2. Launch and see if it works.
3. If it still fails, paste back:
   • The last 50 lines (or more) of ~/Library/Application Support/DozaAssist/server.log — the new build's launcher will already show 50 lines in the error dialog, so you can just copy from there
   • The output of: ls -la "/Applications/Doza Assist.app/Contents/Resources/app/ai_providers/"

One other thing that puzzled me from your screenshot — the browser is trying to load 127.0.0.1:5061, but Doza Assist only uses 5050 (Flask) and 5051 (setup). Port 5061 is also one of the ports Firefox/Zen blocks by default, which is what triggers the "address is restricted" message. Did you type that URL yourself, or did it come from somewhere in the app? Just curious if there's a separate gremlin to chase.

Thanks again for the report.

[samkahn-prog]

@DozaVisuals Thanks for the update.
Now when I attempt to open the app, I see an error popup with this:

Doza Assist cannot start — port 5050 is in use by another process (PID 3779 — Python).

To free the port, open Terminal and run:
    kill 3779

Then relaunch Doza Assist.

End of server.log:

File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/templating.py", line 151, in render_template
    return _render(app, template, context)
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/templating.py", line 128, in _render
    app.update_template_context(context)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 530, in update_template_context
    context.update(self.ensure_sync(func)())
                   ~~~~~~~~~~~~~~~~~~~~~~^^
  File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 87, in inject_brand
    An external launcher (a downstream shell that bundles this Flask
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: cannot import name '__version__' from 'doza_assist' (/Applications/Doza Assist.app/Contents/Resources/app/doza_assist/__init__.py)
127.0.0.1 - - [20/May/2026 15:27:34] "�[35m�[1mGET / HTTP/1.1�[0m" 500 -
Error on request:
Traceback (most recent call last):
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 1511, in wsgi_app
    response = self.full_dispatch_request()
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 919, in full_dispatch_request
    rv = self.handle_user_exception(e)
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 809, in handle_user_exception
    return self.ensure_sync(handler)(e)  # type: ignore[no-any-return]
           ~~~~~~~~~~~~~~~~~~~~~~~~~^^^
  File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 514, in _handle_provider_error
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 917, in full_dispatch_request
    rv = self.dispatch_request()
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 902, in dispatch_request
    return self.ensure_sync(self.view_functions[rule.endpoint])(**view_args)  # type: ignore[no-any-return]
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
  File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 357, in dashboard
    else:
       ^^
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/templating.py", line 151, in render_template
    return _render(app, template, context)
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/templating.py", line 128, in _render
    app.update_template_context(context)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 530, in update_template_context
    context.update(self.ensure_sync(func)())
                   ~~~~~~~~~~~~~~~~~~~~~~^^
  File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 87, in inject_brand
    An external launcher (a downstream shell that bundles this Flask
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: cannot import name '__version__' from 'doza_assist' (/Applications/Doza Assist.app/Contents/Resources/app/doza_assist/__init__.py)

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/werkzeug/serving.py", line 371, in run_wsgi
    execute(self.server.app)
    ~~~~~~~^^^^^^^^^^^^^^^^^
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/werkzeug/serving.py", line 332, in execute
    application_iter = app(environ, start_response)
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 1536, in __call__
    return self.wsgi_app(environ, start_response)
           ~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 1514, in wsgi_app
    response = self.handle_exception(e)
  File "/Users/samkahn/Library/Application Support/DozaAssist/venv/lib/python3.13/site-packages/flask/app.py", line 860, in handle_exception
    server_error = self.ensure_sync(handler)(server_error)
  File "/Applications/Doza Assist.app/Contents/Resources/app/app.py", line 514, in _handle_provider_error
werkzeug.exceptions.InternalServerError: 500 Internal Server Error: The server encountered an internal error and was unable to complete your request. Either the server is overloaded or there is an error in the application.

ai_providers:

ls -la "/Applications/Doza Assist.app/Contents/Resources/app/ai_providers/"
total 104
-rw-r--r--@  1 samkahn  admin   2784 May 20 07:17 __init__.py
drwxr-xr-x@  8 samkahn  admin    256 May 20 07:17 .
drwxr-xr-x@ 21 samkahn  admin    672 May 20 07:17 ..
-rw-r--r--@  1 samkahn  admin  17932 May 20 07:17 anthropic_provider.py
-rw-r--r--@  1 samkahn  admin   2010 May 20 07:17 base.py
-rw-r--r--@  1 samkahn  admin   7821 May 20 07:17 config.py
-rw-r--r--@  1 samkahn  admin   7189 May 20 07:17 ollama_provider.py
-rw-r--r--@  1 samkahn  admin   4522 May 20 07:17 openai_provider.py

[samkahn-prog]

Added note: killing the Python process as noted in the error popup does work. Why would that happen, though?

[DozaVisuals]

Hey Sam — sorry, that's a real bug. Not your install, not your machine.

Here's what's happening:

When the dashboard loads, app.py tries to read the app version from the bundled doza_assist package (app.py:87). On your install that import is failing with cannot import name '__version__'. That crashes the dashboard render, which leaves Flask in a weird half-alive state where it doesn't shut down cleanly — and that's why the next launch hits a stuck port 5050 and needs the kill to free it. The port message you saw is the symptom; the version-import failure is the cause.

The frustrating part: the v3.5.3 source in git does export __version__ (doza_assist/init.py), and the build script even reads that line to set the macOS bundle version. So something on your specific install has a different copy than what's in the repo, and I'd really like to figure out what.

Could you paste back the output of these two commands?

1. The bundled init file:

cat "/Applications/Doza Assist.app/Contents/Resources/app/doza_assist/__init__.py"

2. Any shadow doza_assist in your venv that might be intercepting the import:

find ~/Library/Application\ Support/DozaAssist/venv -name "doza_assist*" -maxdepth 5 2>/dev/null

My two leading theories: (a) the bundled __init__.py somehow got an older version without the __version__ line, despite my build-time check, or (b) something in the venv (maybe a stale pip install from when you re-ran install.sh a few times) is shadowing the bundled package. Either of those commands should tell us.

In parallel, I'm going to ship a defensive fallback so that even if __version__ is missing for any reason, the dashboard reads it as "unknown" instead of crashing — that way the app will at least launch while we pin down the root cause. Will link the fix here when it's up.

Apologies for the runaround on this one, and thanks for sticking with it.

[DozaVisuals]

Quick follow-up — the defensive fallback is up as #30. Once that lands, your install will at least launch and render the dashboard (with version showing as "unknown") even with the broken import. Still need those two command outputs to figure out why the import is broken on your machine, but in the meantime this should unblock you from the unlaunchable-app + stuck-port loop.

[DozaVisuals]

v3.5.4 is up with the defensive fallback: https://github.com/DozaVisuals/doza-assist/releases/tag/v3.5.4

To grab the fix:

1. Download Doza-Assist-3.5.4.dmg from the release page.
2. Open it and drag Doza Assist to Applications, replacing the existing copy.
3. Launch.

With this build, even if the version import is still broken on your machine, the app will launch and the dashboard will render (the version pill will just say "unknown" instead of the real number). That should get you unblocked from the stuck-port / unlaunchable loop.

I still want to figure out why the import was broken on your machine, so when you get a minute those two diagnostics from earlier would help:

cat "/Applications/Doza Assist.app/Contents/Resources/app/doza_assist/__init__.py"
find ~/Library/Application\ Support/DozaAssist/venv -name "doza_assist*" -maxdepth 5 2>/dev/null

If the version pill in 3.5.4 shows "unknown" after install, that confirms the underlying bug is still there and we'll have something to chase. If it shows "3.5.4", then whatever was shadowing the import got cleared by the new install and we're good.

[samkahn-prog]

"""Doza Assist core package."""

__version__ = "3.5.4"