Troubleshooting

Troubleshooting

uv is unavailable

Install uv, open a fresh shell, then run:

uv sync --dev

A direct Python file import fails

Integration modules that use package imports must run in module form:

uv run python -m src.integrations.refresh_all --help

Margin tests fail while converting a placeholder value

An .env copied from the sample may contain literal placeholder text. Remove that local .env or replace placeholders with valid local values before running the tests. Never commit it.

Provider or market-data requests fail

Confirm local credentials and network availability without pasting secrets into logs or issues. Provider success must be verified locally; it cannot be inferred from a passing unit test.

Command documentation disagrees with behavior

Check the source-backed CLI reference, then file or update a GitHub issue with a redacted command and error. Known defects are listed in CLI Reference.