Running a tasks instantly Failes

[salty2011]

Checklist

• I searched existing issues and this hasn't been reported

Area

Not sure

Operating System

Linux

Version

2.7.1

What happened?

I am running the app image version of AutoClaude on BazziteDX (immutable fedora) and when I create a task it immediately fails with a dotenv error, I installed the dotenv python package but now get a bunch of other errors popup

Steps to reproduce

1. Install AutoClaude AppImage
2. Configure AutoClaude as normal
3. Create a task in the project
4. Start the task

Expected behavior

When starting the task it should be going through the process to determine what tasks are available

Logs / Screenshots

Traceback (most recent call last):
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/runners/spec_runner.py", line 97, in <module>
    from spec import SpecOrchestrator
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/__init__.py", line 36, in <module>
    from .pipeline import SpecOrchestrator, get_specs_dir
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/pipeline/__init__.py", line 16, in <module>
    from .orchestrator import SpecOrchestrator
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/pipeline/orchestrator.py", line 33, in <module>
    from ..compaction import (
    ...<3 lines>...
    )
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/compaction.py", line 12, in <module>
    from claude_agent_sdk import ClaudeAgentOptions, ClaudeSDKClient
ModuleNotFoundError: No module named 'claude_agent_sdk'
Traceback (most recent call last):
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/runners/spec_runner.py", line 97, in <module>
    from spec import SpecOrchestrator
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/__init__.py", line 36, in <module>
    from .pipeline import SpecOrchestrator, get_specs_dir
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/pipeline/__init__.py", line 16, in <module>
    from .orchestrator import SpecOrchestrator
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/pipeline/orchestrator.py", line 33, in <module>
    from ..compaction import (
    ...<3 lines>...
    )
  File "/tmp/.mount_autocl2J8ZGl/resources/auto-claude/spec/compaction.py", line 12, in <module>
    from claude_agent_sdk import ClaudeAgentOptions, ClaudeSDKClient
ModuleNotFoundError: No module named 'claude_agent_sdk'

[github-actions]

👋 Thanks for opening your first issue!

A maintainer will triage this soon. In the meantime:

• Make sure you've provided all the requested info
• Join our Discord for faster help

[iamsvenh]

Had the same issue just now. Fixed it by manually installing it in the auto-claude folder:
/opt/Auto-Claude/resources/python/bin$ ./pip3 install claude_agent_sdk

FYI, before that, I had to do the same thing for dotenv:
/opt/Auto-Claude/resources/python/bin$ ./pip3 install python-dotenv

As context I am running on Tuxedo OS, Linux distro

[salty2011]

hey @iamsvenh were you using the app image, the above directories dont exist for me. curious if this is due to ne running on immutable os (BazziteDX)

[iamsvenh]

@salty2011, no the appimage gave me issues so i installed the .deb, which gave many other issues. :D Been on this for the last few hours. Started with the "stable" version that didn't work at all, then ran beta, and keep needing to find workarounds like the above. Very much hoping this gets to a stable level soon(ish). Love the project.

[salty2011]

Ok after some faffing about /gpt troubleshooting and mucking around, the issue is BazziteDX is running Python 3.14, this results in the dependencies for the python virtual environment not installing correctly.

Make sure you have the application closes before proceeding with the following steps, also step 4 youll need to download a copy of the requirements.txt located in this repo under https://github.com/AndyMik90/Auto-Claude/blob/develop/apps/backend/requirements.txt

---

1) Backup the existing virtual environment

mv "$HOME/.config/auto-claude-ui/python-venv" \
   "$HOME/.config/auto-claude-ui/python-venv.bak"

---

2) Install uv (user-local) and create a Python 3.12 venv at the same path

curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

uv python install 3.12
uv venv "$HOME/.config/auto-claude-ui/python-venv" --python 3.12 --seed

---

3) Ensure pip exists and upgrade packaging tools

If pip is missing:

"$HOME/.config/auto-claude-ui/python-venv/bin/python" -m ensurepip --upgrade

Then upgrade tooling:

"$HOME/.config/auto-claude-ui/python-venv/bin/python" -m pip install -U pip setuptools wheel

---

4) Install application requirements

"$HOME/.config/auto-claude-ui/python-venv/bin/python" \
  -m pip install -r /path/to/requirements.txt

---

5) Verify Python version

"$HOME/.config/auto-claude-ui/python-venv/bin/python" -V

Expected output:

Python 3.12.x

---

Rollback (if required)

rm -rf "$HOME/.config/auto-claude-ui/python-venv"
mv "$HOME/.config/auto-claude-ui/python-venv.bak" \
   "$HOME/.config/auto-claude-ui/python-venv"

[aaronvstory]

got the same issue .. on windows though

[salty2011]

@aaronvstory the above steps should relatively the same, just need to change the paths to be windows.

[NoahVl]

Had the same issue on Windows, resolved it by going to the bundled Python install and running the following commands:

In this directory: C:\Users\<your_username>\AppData\Local\Programs\auto-claude-ui\resources\python
.\python.exe -m pip install dotenv
.\python.exe -m pip install claude_agent_sdk

[salty2011]

@NoahVl does that just fix the Insights section... or does it fix other things. Asking cause the requirements.txt has a few other dependancies?

[NoahVl]

@salty2011 it fixed everything up until the review section, but I don't think that's a packages bug. I stopped using the software for now since it's too buggy at this point, I like the UI though!

[amr-swalha-wakecap]

Same issue on windows 11. I tried @NoahVl posted solution but no luck as well, the task always fails.