dearwolf/aider
1
0
Fork 0
mirror of https://github.com/Aider-AI/aider.git synced 2025-05-30 17:24:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

copy

Browse source
This commit is contained in:
Paul Gauthier 2024-12-16 19:50:08 -08:00
parent 9b424e0fe7
commit f237d0f212
3 changed files with 23 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

7
aider/website/docs/install.md
View file

@ -13,10 +13,13 @@ description: How to install and get started pair programming with aider.
{% include get-started.md %} {% include get-started.md %}
This will install aider in its own separate python environment.
If needed, If needed,
aider-install will automatically install a separate version of python 3.12 to use with aider. aider-install will also install a separate version of python 3.12 to use with aider.
Once aider is installed,
there are also some [optional install steps](/docs/install/optional.html).
There are some [optional install steps](/docs/install/optional.html) you could consider.
See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider. See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider.
## One-liners ## One-liners

6
aider/website/docs/install/optional.md
View file

@ -80,8 +80,8 @@ You can use
[aider's `--watch-files` mode](https://aider.chat/docs/usage/watch.html) [aider's `--watch-files` mode](https://aider.chat/docs/usage/watch.html)
to integrate with any IDE or editor. to integrate with any IDE or editor.
Other projects have made plugins for various IDE/editors. There are a number of 3rd party aider plugins for various IDE/editors.
It's not clear if they are tracking the latest It's not clear how well they are tracking the latest
versions of aider, versions of aider,
so it may be best to just run the latest so it may be best to just run the latest
aider in a terminal alongside your editor and use `--watch-files`. aider in a terminal alongside your editor and use `--watch-files`.
@ -101,7 +101,7 @@ There are a number of 3rd party
### Other editors ### Other editors
If you are interested in creating an aider plugin for your favorite editor, If you are interested in creating an aider plugin for your favorite editor,
please let me know by opening a please let us know by opening a
[GitHub issue](https://github.com/Aider-AI/aider/issues). [GitHub issue](https://github.com/Aider-AI/aider/issues).

20
aider/website/docs/more/edit-formats.md
View file

@ -20,7 +20,7 @@ copy of each source file that needs changes.
While simple, it can be slow and costly because the LLM has to return While simple, it can be slow and costly because the LLM has to return
the *entire file* even if just a few lines are edited. the *entire file* even if just a few lines are edited.
The format expects the file path just before the fenced file content: The whole format expects the file path just before the fenced file content:
```` ````
show_greeting.py show_greeting.py
@ -28,7 +28,7 @@ show_greeting.py
import sys import sys
def greeting(name): def greeting(name):
print(f"Hey {{name}}") print("Hey", name)
if __name__ == '__main__': if __name__ == '__main__':
greeting(sys.argv[1]) greeting(sys.argv[1])
@ -42,7 +42,7 @@ The "diff" edit format asks the LLM to specify file edits as a series of search/
This is an efficient format, because the model only needs to return parts of the file This is an efficient format, because the model only needs to return parts of the file
which have changes. which have changes.
They are formatted using a syntax similar to the git merge conflict resolution markings, Edits are formatted using a syntax similar to the git merge conflict resolution markings,
with the file path right before a fenced block: with the file path right before a fenced block:
```` ````
@ -62,7 +62,7 @@ from flask import Flask
The "diff-fenced" edit format is based on the diff format, but The "diff-fenced" edit format is based on the diff format, but
the file path is placed inside the fence. the file path is placed inside the fence.
It is primarily used with the Gemini family of models, It is primarily used with the Gemini family of models,
which often fail to conform to fencing approach specified in the diff format. which often fail to conform to the fencing approach specified in the diff format.
```` ````
``` ```
@ -84,7 +84,10 @@ This is an efficient format, because the model only needs to return parts of the
which have changes. which have changes.
It was mainly used to the GPT-4 Turbo family of models, It was mainly used to the GPT-4 Turbo family of models,
to reduce their "lazy coding" tendencies with other edit formats. because it reduced their "lazy coding" tendencies.
With other edit formats the GPT-4 Turbo models tended to elide
large sections of code and replace them with "# ... original code here ..."
style comments.
```` ````
@ -104,3 +107,10 @@ to reduce their "lazy coding" tendencies with other edit formats.
These are streamlined versions of the diff and whole formats, intended to be used These are streamlined versions of the diff and whole formats, intended to be used
with `--editor-edit-format` when using with `--editor-edit-format` when using
[architect mode](/docs/usage/modes.html). [architect mode](/docs/usage/modes.html).
The actual edit format is the same, but aider uses a simpler prompt that
is more narrowly focused on just editing the file as opposed to
solving the coding task.
The architect model resolves the coding task and
provides plain text instructions about which file changes need to be made.
The editor interprets those instructions to produce the
syntactically correct diff or whole edits.