Troubleshooting¶

ASHA v0.4.2

Installation¶

ImportError: No module named 'asha'¶

pip install asha
# or
pip install -e .

ImportError: cannot import wrap_llm from asha¶

Root no longer exports wrap_llm:

from asha.integrations import wrap_llm

TypeError: unexpected keyword argument¶

Deprecated kwargs were removed. Use mode and PolicyConfig:

from asha.core.policy_config import PolicyConfig
process(prompt, policy=PolicyConfig(pii_mode="hybrid"))

PII not masked¶

from asha import process
from asha.core.policy_config import PolicyConfig

process(prompt, mode="strict")
process(prompt, policy=PolicyConfig(pii_mode="hybrid"))  # needs asha[ml]

Check mode="off" is not set. Check output via result.output, not raw input.

ML / hybrid PII fails¶

pip install asha[ml]

Without ML deps, pii_mode="hybrid" falls back to rule.

process() returns unexpected type¶

v0.4+ always returns ProcessResult:

result = process("prompt")
print(result.output)   # not result["optimized"]
str(result)            # works

wrap_llm errors¶

Use mode="off" only when you intentionally want no preprocessing
mode="strict" raises on processing failure
Prefer wrap_llm() over auto_patch() in shared environments

Agent connection errors¶

agent = Agent(model="mock")  # no API key needed for tests

For real providers, set OPENAI_API_KEY etc. and pip install asha[openai].

Slow processing¶

process(prompt, mode="lite")
process(prompt, mode="off")

Avoid trace=True and debug=True in production hot paths.

AttributeError: Pipeline / Processor¶

Removed in v0.4.1:

from asha import process
from asha.runtime import PromptProcessor

Tests¶

pytest tests -q