Skip to content

[doc] install guide confusing #5115

@LeiYangGH

Description

@LeiYangGH

Issue

I am new user of Aider and follow doc installation.
the first 2 steps(pip install installer, then run installer) done without issues.

but then comes section 'Start working with aider on your codebase:' which says

aider --model deepseek --api-key deepseek=<key>

this is unfriendly to me. I prefer using my own local llm(llama.cpp served). isn't local llm first class citizen in Aider?

and what's worse, the following notes says:

This will install aider in its own separate python environment. If needed, aider-install will also install a separate version of python 3.12 to use with aider.

this is very confusing: this should be refering to closest model configuration statement, why does it necessarily install in its own separate python environment? and if this means the aider-install command, then I would disagree with such design, because we'd like to control my environments like conda, venv, etc, and not relay on aider to. Neither do I see any message in the aider-install process saying it is creating any new python environment.

Version and model info

below is my install process logs, and I am actually in a conda env though it doesn't show explicitly.

PS C:\Users\yang.lei>  uv pip install --default-index https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com aider-install
Using Python 3.12.11 environment at: AppData\Local\miniforge3\envs\data
Resolved 2 packages in 6.03s
Prepared 1 package in 394ms
Installed 1 package in 329ms
 + aider-install==0.2.0
PS C:\Users\yang.lei>  aider-install
Resolved 110 packages in 10.13s
Prepared 110 packages in 26.95s
Installed 110 packages in 5.07s
 + aider-chat==0.86.2
 + aiohappyeyeballs==2.6.1
 + aiohttp==3.13.3
 + aiosignal==1.4.0
 + annotated-doc==0.0.4
 + annotated-types==0.7.0
 + anyio==4.12.1
 + asgiref==3.11.1
 + attrs==25.4.0
 + backoff==2.2.1
 + beautifulsoup4==4.14.3
 + certifi==2026.1.4
 + cffi==2.0.0
 + charset-normalizer==3.4.4
 + click==8.3.1
 + colorama==0.4.6
 + configargparse==1.7.1
 + diff-match-patch==20241021
 + diskcache==5.6.3
 + distro==1.9.0
 + fastapi==0.128.8
 + fastuuid==0.14.0
 + filelock==3.20.3
 + flake8==7.3.0
 + frozenlist==1.8.0
 + fsspec==2026.2.0
 + gitdb==4.0.12
 + gitpython==3.1.46
 + grep-ast==0.9.0
 + h11==0.16.0
 + hf-xet==1.2.0
 + httpcore==1.0.9
 + httpx==0.28.1
 + huggingface-hub==1.4.1
 + idna==3.11
 + importlib-metadata==7.2.1
 + importlib-resources==6.5.2
 + jinja2==3.1.6
 + jiter==0.13.0
 + json5==0.13.0
 + jsonschema==4.26.0
 + jsonschema-specifications==2025.9.1
 + litellm==1.81.10
 + markdown-it-py==4.0.0
 + markupsafe==3.0.3
 + mccabe==0.7.0
 + mdurl==0.1.2
 + mixpanel==5.0.0
 + mslex==1.3.0
 + multidict==6.7.1
 + networkx==3.4.2
 + numpy==1.26.4
 + openai==2.20.0
 + orjson==3.11.7
 + oslex==0.1.3
 + packaging==26.0
 + pathspec==1.0.4
 + pexpect==4.9.0
 + pillow==12.1.1
 + pip==26.1.1
 + posthog==7.8.6
 + prompt-toolkit==3.0.52
 + propcache==0.4.1
 + psutil==7.2.2
 + ptyprocess==0.7.0
 + pycodestyle==2.14.0
 + pycparser==3.0
 + pydantic==2.12.5
 + pydantic-core==2.41.5
 + pydub==0.25.1
 + pyflakes==3.4.0
 + pygments==2.19.2
 + pypandoc==1.16.2
 + pyperclip==1.11.0
 + python-dateutil==2.9.0.post0
 + python-dotenv==1.2.1
 + pyyaml==6.0.3
 + referencing==0.37.0
 + regex==2026.1.15
 + requests==2.32.5
 + rich==14.3.2
 + rpds-py==0.30.0
 + scipy==1.15.3
 + shellingham==1.5.4
 + shtab==1.8.0
 + six==1.17.0
 + smmap==5.0.2
 + sniffio==1.3.1
 + socksio==1.0.0
 + sounddevice==0.5.5
 + soundfile==0.13.1
 + soupsieve==2.8.3
 + starlette==0.52.1
 + tiktoken==0.12.0
 + tokenizers==0.22.2
 + tqdm==4.67.3
 + tree-sitter==0.25.2
 + tree-sitter-c-sharp==0.23.1
 + tree-sitter-embedded-template==0.25.0
 + tree-sitter-language-pack==0.13.0
 + tree-sitter-yaml==0.7.2
 + typer==0.23.0
 + typer-slim==0.23.0
 + typing-extensions==4.15.0
 + typing-inspection==0.4.2
 + urllib3==2.6.3
 + watchfiles==1.1.1
 + wcwidth==0.6.0
 + yarl==1.22.0
 + zipp==3.23.0
Installed 1 executable: aider
warning: `C:\Users\yang.lei\.local\bin` is not on your PATH. To use installed tools, run `$env:PATH = "C:\Users\yang.lei\.local\bin;$env:PATH"` or `uv tool update-shell`.
Updated PATH to include executable directory C:\Users\yang.lei\.local\bin
Restart your shell to apply changes
PS C:\Users\yang.lei>

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions