# aicode
The most advanced ai coding tool on the planet.
[](../../actions/workflows/lint.yml)
[](../../actions/workflows/push_macos.yml)
[](../../actions/workflows/push_ubuntu.yml)
[](../../actions/workflows/push_win.yml)
# About
Okay well `aider.chat` is by far the BEST aicoding assistant on the planet. But `aicode`, a front end for
`aider.chat` is EASIER TO USE! So use this whenever you can for Windows/Linux/MacOS.
Think of `aicode` as `aider.chat` but on easy mode.
One foot gun here is that `aider.chat` only works on files in a git repo. therefore you must be in a git repo
for `aicode` to work. This is required because `aider.chat` will generate a repo map as part of the query.
## Usage:
```bash
pip install advanced-aicode
aicode
```
### Note
The package name is NOT the same as the command tool. The package is `advanced-aicode` and the tool is called `aicode`. Someone
else grabbed package name `aicode` over a year ago and this is the best name I could come up with to get it into pypi.
# aicode is better than aider.chat in the following ways
* `aicode` is easier to install. Like WAY easier. It will tell you what you need to do to complete the installation, such
as setting the api key if none are detected.
* `aicode` will not f@ck up your global pip environment. We fix this by lazily installing `aider.chat` using `pipx`
* `aicode` will change the directory to a the project root containing a `.git` directory. `aider.chat` will just fail to run.
* `aicode` will default to NOT creating a git commit on every change. Instead it will
just raw dog it to your current repo. This simplifies usage because most of the time you will
only be editing one file and if you don't like the change you can just invoke undo on the file.
If you want to create a git commit on every change (so that you can use /undo)
then pass in `aicode -a`. This works better if you are editing multiple files and want and want
to step back in history, must most of the time it's better to just let `aicode` work on one file
at a time.
* `aicode` has the benefit of allowing easy upgrades to `aider.chat` from the command line using `aicode --update` which will
invoke `pipx` update on the backend.
* `aicode` will default to using `ChatGPT4-o` if it detects you have have an openapi key.
* `aicode` will save and insert the environmental variables on demand. `aider.chat` requires that you
insert these variables in your `~/.bashrc` file (linux) or the equivalent for Windows and MacOS.
* `aicode` will check for new versions in the background and inform you of an update on the NEXT run of
`aicode` and the command line you can use. This was a feature that `aider.chat` program actually implemented for this project.
* `aicode` will ask you to modify the `.gitignore` file so that you aren't uploading your f*cking chat
history to your repo by default.
Happy CODING!
# Releases
* 2.0.2 - If there is chat history then aicode will ask if you want to restore it.
* 2.0.1 - Implement disabling of git if a git directory can't be found.
* 2.0.0 - Implemented aider's new "architect" mode, which although is a small change in the code, does change how the product is used.
Disable this by using `--no-architect` to get the old behavior.
* 1.2.16 - Linting is disable by default
* 1.2.15 - Aider is now installed in a side package. This means Aider won't be cleared when you uninstall `advanced-aicode` but should resolve the issue with OSX throwing exceptions for locked files. See `aicode --purge`
* 1.2.14 - Fixes wrong VIRTUAL ENV path.
* 1.2.13 - Fixes KeyboardInterrupt exception in trampoline.
* 1.2.12 - Final fixes (I hope) in this cycle.
* 1.2.11 - Fixes some issues with warnings being emitted.
* 1.2.10 - Adds missing `setuptools` dependency that was causing a non fatal error.
* 1.2.9 - Now uses trampoline to re-root the cwd when calling the program. Fixes Linux/MacOS.
* 1.2.8 - `aicode --upgrade` now more robust. Also fixed a path issue on windows.
* 1.2.7 - `aicode --upgrade` has been fixed to work with `uv` package upgrades.
* 1.2.6 - Re-rooting trick fails for mac/linux, only apply it for win32
* 1.2.5 - Cwd directory is inserted so aider-chat backend is invoked from the current command line.
* 1.2.4 - Switch isolated environment to an ad-hoc usage of `uv`. Much faster and better!
* 1.2.3 - Fixes a win32 bug related to `isolated-environment`
* 1.2.2 - Propagate fixes from `isolated-environment` to fix Mac/Linux
* 1.2.1 - Buf fix for isolated-environment by using `shell=True`.
* 1.2.0 - Aider is now installed with `isolated-environment` instead of `pipx` for better isolation. We now use `keyring` to securely store your api keys.
* 1.1.8 - Custom path now set for pipx, should fix most pipx issues.
* 1.1.7 - Version detection fixed now that the api has been made much better.
* 1.1.6 - Fixes has update when the versions match
* 1.1.5 - Fixes `--just-check-update` which had a typo in the last version as `--just-check-updated`
* 1.1.4 - Fixes `aider --check-update` with `--just-check-update`
* 1.1.3 - Fixes `aider --skip-check-update` which is now `--no-check-update`
* 1.1.1 - Fix a infinit recursion loop while trying to find the .git directory.
* 1.1.0 - The --slow, --fast, --claude3 are not long used. Now it's just --chatgpt and --claude.
* 1.0.4 - If `--upgrade` fails, then attempt recovery by asking the user to upgrade `pipx` and then try again.
* 1.0.3 - Improved version parsing so that stuff like X.X.X-dev can be parsed.
* 1.0.2 - `--claude3`` now maps to sonnet mode. This is now the default if both keys are present for claude3 and openai.
* 1.0.1 - Improve readme.
* 1.0.0 - Initial release.
Raw data
{
"_id": null,
"home_page": "https://github.com/zackees/aicode",
"name": "advanced-aicode",
"maintainer": "Zachary Vorhies",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "template-python-cmd",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/e0/00/9d777f144ed013c9bd59d80483ba8dbdc9ca4258f317104877293966bcf9/advanced_aicode-2.0.2.tar.gz",
"platform": null,
"description": "# aicode\r\n\r\nThe most advanced ai coding tool on the planet.\r\n\r\n[](../../actions/workflows/lint.yml)\r\n\r\n[](../../actions/workflows/push_macos.yml)\r\n[](../../actions/workflows/push_ubuntu.yml)\r\n[](../../actions/workflows/push_win.yml)\r\n\r\n\r\n# About\r\n\r\nOkay well `aider.chat` is by far the BEST aicoding assistant on the planet. But `aicode`, a front end for\r\n`aider.chat` is EASIER TO USE! So use this whenever you can for Windows/Linux/MacOS.\r\nThink of `aicode` as `aider.chat` but on easy mode.\r\n\r\nOne foot gun here is that `aider.chat` only works on files in a git repo. therefore you must be in a git repo\r\nfor `aicode` to work. This is required because `aider.chat` will generate a repo map as part of the query.\r\n\r\n\r\n## Usage:\r\n\r\n```bash\r\npip install advanced-aicode\r\naicode\r\n```\r\n\r\n### Note\r\n\r\nThe package name is NOT the same as the command tool. The package is `advanced-aicode` and the tool is called `aicode`. Someone\r\nelse grabbed package name `aicode` over a year ago and this is the best name I could come up with to get it into pypi.\r\n\r\n\r\n# aicode is better than aider.chat in the following ways\r\n\r\n\r\n * `aicode` is easier to install. Like WAY easier. It will tell you what you need to do to complete the installation, such\r\n as setting the api key if none are detected.\r\n * `aicode` will not f@ck up your global pip environment. We fix this by lazily installing `aider.chat` using `pipx`\r\n * `aicode` will change the directory to a the project root containing a `.git` directory. `aider.chat` will just fail to run.\r\n * `aicode` will default to NOT creating a git commit on every change. Instead it will\r\n just raw dog it to your current repo. This simplifies usage because most of the time you will\r\n only be editing one file and if you don't like the change you can just invoke undo on the file.\r\n If you want to create a git commit on every change (so that you can use /undo)\r\n then pass in `aicode -a`. This works better if you are editing multiple files and want and want\r\n to step back in history, must most of the time it's better to just let `aicode` work on one file\r\n at a time.\r\n * `aicode` has the benefit of allowing easy upgrades to `aider.chat` from the command line using `aicode --update` which will\r\n invoke `pipx` update on the backend.\r\n * `aicode` will default to using `ChatGPT4-o` if it detects you have have an openapi key.\r\n * `aicode` will save and insert the environmental variables on demand. `aider.chat` requires that you\r\n insert these variables in your `~/.bashrc` file (linux) or the equivalent for Windows and MacOS.\r\n * `aicode` will check for new versions in the background and inform you of an update on the NEXT run of\r\n `aicode` and the command line you can use. This was a feature that `aider.chat` program actually implemented for this project.\r\n * `aicode` will ask you to modify the `.gitignore` file so that you aren't uploading your f*cking chat\r\n history to your repo by default.\r\n\r\nHappy CODING!\r\n\r\n# Releases\r\n * 2.0.2 - If there is chat history then aicode will ask if you want to restore it.\r\n * 2.0.1 - Implement disabling of git if a git directory can't be found.\r\n * 2.0.0 - Implemented aider's new \"architect\" mode, which although is a small change in the code, does change how the product is used.\r\n Disable this by using `--no-architect` to get the old behavior.\r\n * 1.2.16 - Linting is disable by default\r\n * 1.2.15 - Aider is now installed in a side package. This means Aider won't be cleared when you uninstall `advanced-aicode` but should resolve the issue with OSX throwing exceptions for locked files. See `aicode --purge`\r\n * 1.2.14 - Fixes wrong VIRTUAL ENV path.\r\n * 1.2.13 - Fixes KeyboardInterrupt exception in trampoline.\r\n * 1.2.12 - Final fixes (I hope) in this cycle.\r\n * 1.2.11 - Fixes some issues with warnings being emitted.\r\n * 1.2.10 - Adds missing `setuptools` dependency that was causing a non fatal error.\r\n * 1.2.9 - Now uses trampoline to re-root the cwd when calling the program. Fixes Linux/MacOS.\r\n * 1.2.8 - `aicode --upgrade` now more robust. Also fixed a path issue on windows.\r\n * 1.2.7 - `aicode --upgrade` has been fixed to work with `uv` package upgrades.\r\n * 1.2.6 - Re-rooting trick fails for mac/linux, only apply it for win32\r\n * 1.2.5 - Cwd directory is inserted so aider-chat backend is invoked from the current command line.\r\n * 1.2.4 - Switch isolated environment to an ad-hoc usage of `uv`. Much faster and better!\r\n * 1.2.3 - Fixes a win32 bug related to `isolated-environment`\r\n * 1.2.2 - Propagate fixes from `isolated-environment` to fix Mac/Linux\r\n * 1.2.1 - Buf fix for isolated-environment by using `shell=True`.\r\n * 1.2.0 - Aider is now installed with `isolated-environment` instead of `pipx` for better isolation. We now use `keyring` to securely store your api keys.\r\n * 1.1.8 - Custom path now set for pipx, should fix most pipx issues.\r\n * 1.1.7 - Version detection fixed now that the api has been made much better.\r\n * 1.1.6 - Fixes has update when the versions match\r\n * 1.1.5 - Fixes `--just-check-update` which had a typo in the last version as `--just-check-updated`\r\n * 1.1.4 - Fixes `aider --check-update` with `--just-check-update`\r\n * 1.1.3 - Fixes `aider --skip-check-update` which is now `--no-check-update`\r\n * 1.1.1 - Fix a infinit recursion loop while trying to find the .git directory.\r\n * 1.1.0 - The --slow, --fast, --claude3 are not long used. Now it's just --chatgpt and --claude.\r\n * 1.0.4 - If `--upgrade` fails, then attempt recovery by asking the user to upgrade `pipx` and then try again.\r\n * 1.0.3 - Improved version parsing so that stuff like X.X.X-dev can be parsed.\r\n * 1.0.2 - `--claude3`` now maps to sonnet mode. This is now the default if both keys are present for claude3 and openai.\r\n * 1.0.1 - Improve readme.\r\n * 1.0.0 - Initial release.\r\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "Front End for Aider.chat which makes it super simple to use",
"version": "2.0.2",
"project_urls": {
"Homepage": "https://github.com/zackees/aicode"
},
"split_keywords": [
"template-python-cmd"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "56c051a26ce6b92dff870e882b90db27f2a9bc2e831c1da3a2a163375f74ca8c",
"md5": "6a8888ecc8723f6a546d42bda75fc738",
"sha256": "8827d87494c4a847ebf21a6e7ee8f45c0172b9cd5668a358d13cfd403b0ac224"
},
"downloads": -1,
"filename": "advanced_aicode-2.0.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "6a8888ecc8723f6a546d42bda75fc738",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.10",
"size": 13792,
"upload_time": "2024-11-12T07:05:07",
"upload_time_iso_8601": "2024-11-12T07:05:07.383002Z",
"url": "https://files.pythonhosted.org/packages/56/c0/51a26ce6b92dff870e882b90db27f2a9bc2e831c1da3a2a163375f74ca8c/advanced_aicode-2.0.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e0009d777f144ed013c9bd59d80483ba8dbdc9ca4258f317104877293966bcf9",
"md5": "485e2e0220e57cfe86315922af876bde",
"sha256": "884963a8259841a42b73a4044b2ab5d6e699a2da83980de871c584996c5472f8"
},
"downloads": -1,
"filename": "advanced_aicode-2.0.2.tar.gz",
"has_sig": false,
"md5_digest": "485e2e0220e57cfe86315922af876bde",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 21856,
"upload_time": "2024-11-12T07:05:08",
"upload_time_iso_8601": "2024-11-12T07:05:08.307327Z",
"url": "https://files.pythonhosted.org/packages/e0/00/9d777f144ed013c9bd59d80483ba8dbdc9ca4258f317104877293966bcf9/advanced_aicode-2.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-12 07:05:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zackees",
"github_project": "aicode",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "advanced-aicode"
}
JSON
