Aider error
Aider: aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage...
aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage U.W.V which is incompatible.Status: WorkaroundLast verified 3 documented fixes2 sources
What it means
Aider is installed with the wrong versions of its dependencies. This shows up as pip conflict messages like the one above, or as ImportErrors when aider runs. Aider pins its dependencies and is tested with those exact versions.
Causes
- Installing aider into the same Python environment as a project that needs conflicting package versions (official docs).
- Package managers like Homebrew, AUR or ports installing aider with the wrong dependencies (official docs).
- Upgrading or downgrading pinned packages, especially litellm, which changes versions often (official docs).
How to fix it
- Fix 1.
Install aider into its own Python environment with aider-install, uv or pipx.
Terminalcurl -LsSf https://aider.chat/install.sh | sh - Fix 2.
Or install with uv.
Snippetuv tool install --force --python python3.12 --with pip aider-chat@latest - Fix 3.
If you install with pip directly, avoid changing the packages pinned at the end of aider's requirements.in, and be careful about upgrading litellm.
More Aider errors
All 17 Aider errorsThe LLM did not conform to the edit format.Status: WorkaroundSearchReplaceNoExactMatch: This SEARCH block failed to exactly match lines in {path}Status: WorkaroundModel gpt-3.5-turbo has hit a token limit!Status: WorkaroundModel foobar: Unknown context window size and costs, using sane defaults.Status: By designModel azure/gpt-4-turbo: Missing these environment variables:Status: By designaider: The term 'aider' is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.Status: WorkaroundThe API provider is not able to authenticate you. Check your API key.Status: By designThe API provider has rate limited you. Try again later or check your quotas.Status: By design
Related reading
- Aider vs Claude Code in 2026: Git-First Open Source vs Subagent RuntimeAider vs Claude Code: git-first, model-agnostic Aider against the Claude Code runtime of subagents and hooks. Compare architecture, cost, governance and fit.
- Aider vs Claude Code: Open Source vs Commercial AI Coding CLIAider is open source and works with any model. Claude Code is Anthropic's commercial agent. Here is how they compare for TypeScript.
FAQ
What does "aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage..." mean in Aider?
Aider is installed with the wrong versions of its dependencies. This shows up as pip conflict messages like the one above, or as ImportErrors when aider runs. Aider pins its dependencies and is tested with those exact versions.
How do I fix "aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage..."?
There are 3 documented fixes. Start with the first: Install aider into its own Python environment with aider-install, uv or pipx.
Is this Aider error fixed?
Status: Workaround. No release removes the cause. The documented fixes work around it. Affected versions: All versions.
Sources
Last verified against 2 sources: official docs, maintainer replies and release notes.
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.