start.sh: MCP installation fails with older uv due to directory shadowing

Open Beginner friendly
#106 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
python
Domain
cli

Research direction

Open start.sh and compare the existing UI launch command with the MCP installation and retry commands. Reproduce the failure from the repository root with uv run artemis mcp --help, then verify the MCP help and installation commands succeed with the Python module entry point under the reported older uv environment.

Written by the indexing model from the issue text.

Description

Description

When running ./start.sh from the repository root and choosing to install MCP configuration, installation fails with:

ImportError: cannot import name 'RunTree' from 'langsmith'
(<project>/.venv/lib/python3.14/site-packages/langsmith/__init__.py)

The Showcase UI build completes successfully before this failure.

Environment
  • macOS
  • Python 3.14.5
  • uv 0.5.9
  • Repository commit: 371aa6d
Reproduction

From the repository root:

uv run artemis mcp --help

This reproduces the same import error without modifying IDE configuration.

Verbose uv output shows:

DEBUG Running `python artemis mcp --help`
Cause

In this environment, uv interprets artemis as the local directory instead of invoking the installed console script. This places the package directory on the module search path, allowing artemis/platform to shadow Python's standard-library platform module.

Expected behavior

The MCP command should run successfully from the repository root.

Verified workaround
uv run python -m artemis mcp --help
uv run python -m artemis mcp --install all

Both commands succeed with the same Python environment and dependencies.

Proposed fix

Use uv run python -m artemis for MCP installation and the retry instructions in start.sh, consistent with the script's existing UI launch command.

Dominant language
Python
Stars
8.2k
Forks
779
Avg merge
20m
Merged PRs (30d)
4

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from google/artemis

All issues in google/artemis

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.