Base ouroboros-ai install is missing litellm, but ouroboros pm imports it unconditionally

[srausser]

Summary

A base ouroboros-ai install can succeed, but ouroboros pm crashes immediately because it imports litellm unconditionally even though litellm is not installed.

Repro

1. Install the base package only:

uv tool install --python /opt/homebrew/bin/python3.12 ouroboros-ai

2. Run:

ouroboros pm

Actual

The command crashes with:

ModuleNotFoundError: No module named 'litellm'

Traceback points to:

• ouroboros/cli/commands/pm.py
• ouroboros/providers/litellm_adapter.py

The failing import path is effectively:

• pm.py imports LiteLLMAdapter
• litellm_adapter.py imports litellm

Expected

One of these should be true:

1. litellm is included in the base dependencies if pm requires it.
2. pm should gracefully fail with an actionable install hint.
3. pm should only import the adapter in code paths where the dependency is available.

Local workaround

I fixed my local tool install with:

uv tool install --python /opt/homebrew/bin/python3.12 --force --with litellm ouroboros-ai

After adding litellm, ouroboros pm starts normally.

[ouroboros-agent]

Triage result: this is a reproducible bug in the \ CLI path, not a docs/question issue.

Why it passes triage

• Reproduction steps are present
• Actual vs expected behavior is clear
• The reported failure points to a narrow import/dependency boundary (\ and )
• No existing PR appears to be linked to this issue

Scope assessment
This looks like a safe single-PR fix rather than a multi-PR design effort. Likely resolution paths are one of:

1. include \ in the base dependency set if \ requires it,
2. defer the import and fail gracefully with an install hint, or
3. gate the adapter import behind an optional dependency check.

Routing this forward as a fix-ready bug for implementation.

ouroboros-agent[bot]

[ouroboros-agent]

Follow-up triage note (correcting formatting from the previous bot comment):

This is a reproducible bug in the ouroboros pm CLI path.

Why it passes triage

• Reproduction steps are present
• Actual vs expected behavior is clear
• The reported failure points to a narrow import/dependency boundary in src/ouroboros/cli/commands/pm.py and src/ouroboros/providers/litellm_adapter.py
• No existing PR appears to be linked to this issue

Scope assessment
This looks like a safe single-PR fix rather than a multi-PR design effort. Likely resolution paths are one of:

1. include litellm in the base dependency set if pm requires it,
2. defer the import and fail gracefully with an install hint, or
3. gate the adapter import behind an optional dependency check.

Routing this forward as a fix-ready bug for implementation.

ouroboros-agent[bot]