moved website/ -> aider/website/

aider/website/docs/install/codespaces.md

@@ -0,0 +1,39 @@
+---
+title: GitHub Codespaces
+parent: Installation
+nav_order: 900
+---
+
+# GitHub Codespaces
+
+You can use aider in GitHub Codespaces via the built-in Terminal pane.
+See below for an example,
+but you can see the 
+[main install instructions](/docs/install.html)
+for all the details.
+
+
+<div class="video-container">
+  <video controls poster="/assets/codespaces.jpg">
+    <source src="/assets/codespaces.mp4" type="video/mp4">
+    <a href="/assets/codespaces.mp4">Install aider in GitHub Codespaces</a>
+  </video>
+</div>
+
+<style>
+.video-container {
+  position: relative;
+  padding-bottom: 101.89%; /* 1080 / 1060 = 1.0189 */
+  height: 0;
+  overflow: hidden;
+}
+
+.video-container video {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+}
+</style>
+

aider/website/docs/install/docker.md

@@ -0,0 +1,36 @@
+---
+parent: Installation
+nav_order: 100
+---
+
+# Aider with docker
+
+You can run aider via docker without doing any local installation, like this:
+
+```
+docker pull paulgauthier/aider
+docker run -it --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]
+```
+
+You should run the above commands from the root of your git repo,
+since the `--volume` arg maps your current directory into the
+docker container.
+Given that, you need to be in the root of your git repo for aider to be able to
+see the repo and all its files.
+
+You should be sure your that
+git repo config contains your user name and email, since the
+docker container won't have your global git config.
+Run these commands while in your git repo, before
+you do the `docker run` command:
+
+```
+git config user.email "you@example.com"
+git config user.name "Your Name"
+```  
+
+
+## Limitations
+
+- When you use the in-chat `/run` command, it will be running shell commands *inside the docker container*. So those commands won't be running in your local environment, which may make it tricky to `/run` tests, etc for your project.
+- The `/voice` command won't work unless you can figure out how to give the docker container access to your host audio device. The container has libportaudio2 installed, so it should work if you can do that.

aider/website/docs/install/install.md

@@ -0,0 +1,69 @@
+---
+parent: Installation
+nav_order: 10
+---
+
+# Installing aider
+{: .no_toc }
+
+- TOC
+{:toc}
+
+## Install git
+
+Make sure you have git installed.
+Here are
+[instructions for installing git in various environments](https://github.com/git-guides/install-git).
+
+## Get your API key
+
+To work with OpenAI's GPT 3.5 or GPT-4 models you need a paid
+[OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key).
+Note that this is different than being a "ChatGPT Plus" subscriber.
+
+To work with Anthropic's models like Claude 3 Opus you need a paid
+[Anthropic API key](https://docs.anthropic.com/claude/reference/getting-started-with-the-api).
+
+## Manage your python environment
+
+Using a Python 
+[virtual environment](https://docs.python.org/3/library/venv.html)
+is recommended.
+Or, you could consider 
+[installing aider using pipx](/docs/install/pipx.html).
+
+## Windows install
+
+```
+# Install aider
+py -m pip install aider-chat
+
+# To work with GPT-4o:
+$ aider --openai-api-key sk-xxx...
+
+# To work with Claude 3 Opus:
+$ aider --anthropic-api-key sk-xxx... --opus
+```
+
+## Mac/Linux install
+
+```
+# Install aider
+python -m pip install aider-chat
+
+# To work with GPT-4o:
+$ aider --openai-api-key sk-xxx...
+
+# To work with Claude 3 Opus:
+$ aider --anthropic-api-key sk-xxx... --opus
+```
+
+## Working with other LLMs
+
+Aider works well with GPT-4o, Claude 3 Opus, GPT-3.5 and supports [connecting to almost any LLM](https://aider.chat/docs/llms.html).
+
+## You are done!
+
+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.
+

aider/website/docs/install/optional.md

@@ -0,0 +1,101 @@
+---
+parent: Installation
+nav_order: 20
+---
+
+# Optional steps
+{: .no_toc }
+
+The steps below are completely optional.
+
+- TOC
+{:toc}
+
+
+## Store your api keys 
+
+You can place your [api keys in a `.env` file](/docs/config/dotenv.html)
+and they will be loaded automatically whenever you run aider.
+
+## Enable Playwright 
+
+Aider supports adding web pages to the chat with the `/web <url>` command.
+When you add a url to the chat, aider fetches the page and scrapes its
+content.
+
+By default, aider uses the `httpx` library to scrape web pages, but this only
+works on a subset of web pages.
+Some sites explicitly block requests from tools like httpx.
+Others rely heavily on javascript to render the page content,
+which isn't possible using only httpx.
+
+Aider works best with all web pages if you install
+Playwright's chromium browser and its dependencies:
+
+```
+playwright install --with-deps chromium
+```
+
+See the
+[Playwright for Python documentation](https://playwright.dev/python/docs/browsers#install-system-dependencies)
+for additional information.
+
+
+## Enable voice coding 
+
+Aider supports [coding with your voice](https://aider.chat/docs/voice.html)
+using the in-chat `/voice` command.
+Aider uses the [PortAudio](http://www.portaudio.com) library to
+capture audio.
+Installing PortAudio is completely optional, but can usually be accomplished like this:
+
+- For Windows, there is no need to install PortAudio.
+- For Mac, do `brew install portaudio`
+- For Linux, do `sudo apt-get install libportaudio2`
+
+## Add aider to your editor 
+
+Other projects have integrated aider into some IDE/editors.
+It's not clear if they are tracking the latest
+versions of aider,
+so it may be best to just run the latest
+aider in a terminal alongside your editor.
+
+### NeoVim
+
+[joshuavial](https://github.com/joshuavial) provided a NeoVim plugin for aider:
+
+[https://github.com/joshuavial/aider.nvim](https://github.com/joshuavial/aider.nvim)
+
+### VS Code
+
+joshuavial also confirmed that aider works inside a VS Code terminal window.
+Aider detects if it is running inside VSCode and turns off pretty/color output,
+since the VSCode terminal doesn't seem to support it well.
+
+[MattFlower](https://github.com/MattFlower) provided a VSCode plugin for aider:
+
+[https://marketplace.visualstudio.com/items?itemName=MattFlower.aider](https://marketplace.visualstudio.com/items?itemName=MattFlower.aider)
+
+### Other editors
+
+If you are interested in creating an aider plugin for your favorite editor,
+please let me know by opening a
+[GitHub issue](https://github.com/paul-gauthier/aider/issues).
+
+
+## Install the development version of aider 
+
+If you want the very latest development version of aider
+you can install directly from GitHub:
+
+```
+python -m pip install --upgrade git+https://github.com/paul-gauthier/aider.git
+```
+
+If you've git cloned the aider repository already, you can install "live" from your local copy. This is mostly useful if you are developing aider and want your current modifications to take effect immediately.
+
+```
+python -m pip install -e .
+```
+

aider/website/docs/install/pipx.md

@@ -0,0 +1,27 @@
+---
+parent: Installation
+nav_order: 100
+---
+
+# Install with pipx
+
+If you are using aider to work on a python project, sometimes your project will require
+specific versions of python packages which conflict with the versions that aider
+requires.
+If this happens, the `pip install` command may return errors like these:
+
+```
+aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage U.W.V which is incompatible.
+```
+
+You can avoid this problem by installing aider using `pipx`,
+which will install it globally on your system
+within its own python environment.
+This way you can use aider to work on any python project,
+even if that project has conflicting dependencies.
+
+Install [pipx](https://pipx.pypa.io/stable/) then just do:
+
+```
+pipx install aider-chat
+```