[Bug]: agentstack run fails with ModuleNotFoundError: No module named 'agents' after project initialization on macOS (Python 3.12)

[amaan-ai20]

Contact Details

amaan@ai20labs.com

📦 Package Version

0.3.5

🎞️ Framework Version

No response

🔎 Describe the Bug

After initializing a new AgentStack project on macOS (Apple Silicon) with agentstack init, running agentstack run immediately fails with:

Failed to import AgentStack project at: /path/to/project
No module named 'agents'

It appears that the generated project is missing a required agents module or dependency.

---

To Reproduce
Steps to reproduce the behavior:

1. Install AgentStack CLI.
2. Run agentstack init agentstack_starter.
3. Select any template (e.g., hello_alex).
4. cd agentstack_starter
5. source .venv/bin/activate
6. Run agentstack run

Expected behavior
The initialized agent project should run out of the box without missing module errors.

---

Environment (please complete the following information):

• OS: macOS (Apple Silicon, M1/M2/M3)
• Python Version: 3.12.10
• AgentStack Version: Latest (as of April 2025)
• Installed using: uv and default agentstack instructions

---

Additional Context
The full traceback points to agentops trying to import from agents import Span, but the agents module is not found in the generated project or installed packages.

There seems to be a missing dependency, incorrect import, or misconfiguration in the generated starter project.

---

Full Error Log

(agentstack_starter) amaan@Amaans-MacBook-Pro agentstack_starter % agentstack run --debug
Running your agent...
An error occurred: 
Failed to import AgentStack project at: /Users/amaan/Workspace/GitHub-Issues/agentstack_starter
No module named 'agents'
DEBUG: Full traceback:
Traceback (most recent call last):
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/cli/run.py", line 125, in run_project
    project_main = _import_project_module(conf.PATH)
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/cli/run.py", line 93, in _import_project_module
    spec.loader.exec_module(project_module)
  File "<frozen importlib._bootstrap_external>", line 999, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/src/main.py", line 5, in <module>
    import agentops
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/__init__.py", line 2, in <module>
    from agentops.client import Client
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/__init__.py", line 1, in <module>
    from .client import Client
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/client.py", line 4, in <module>
    from agentops.client.api import ApiClient
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/api/__init__.py", line 9, in <module>
    from agentops.client.api.base import BaseApiClient
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/api/base.py", line 12, in <module>
    from agentops.client.http.http_client import HttpClient
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/http/http_client.py", line 5, in <module>
    from agentops.client.http.http_adapter import BaseHTTPAdapter
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/client/http/http_adapter.py", line 7, in <module>
    from agentops.exceptions import AgentOpsApiJwtExpiredException, ApiServerException
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/exceptions.py", line 1, in <module>
    from agentops.logging import logger
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/logging/__init__.py", line 2, in <module>
    from .instrument_logging import setup_print_logger, upload_logfile
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentops/logging/instrument_logging.py", line 7, in <module>
    from agents import Span
ModuleNotFoundError: No module named 'agents'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/main.py", line 268, in main
    _main()
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/main.py", line 254, in _main
    raise e
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/main.py", line 224, in _main
    run_project(command=args.function, cli_args=extra_args)
  File "/Users/amaan/Workspace/GitHub-Issues/agentstack_starter/.venv/lib/python3.12/site-packages/agentstack/cli/run.py", line 134, in run_project
    raise ValidationError(f"Failed to import AgentStack project at: {conf.PATH.absolute()}\n{e}")
agentstack.exceptions.ValidationError: Failed to import AgentStack project at: /Users/amaan/Workspace/GitHub-Issues/agentstack_starter
No module named 'agents'

🤝 Contribution

• Yes, I'd be happy to submit a pull request with these changes.
• I need some guidance on how to contribute.
• I'd prefer the AgentStack team to handle this update.

[amaan-ai20]

When I add openai-agents manually via uv, and then run agentstack run. I get the following error.

(agentstack_starter) Amaans-MacBook-Pro:agentstack_starter amaan$ agentstack run
Running your agent...
An error occurred: 
Failed to import AgentStack project at: /Users/amaan/Workspace/Dappier/agentstack_starter
No module named 'crewai.utilities.tool_utils'
Run again with --debug for more information.

[amaan-ai20]

I guess this can be resolved if we move to the latest crewai version.

[bboynton97]

versions updated to resolve this :) thank you!