स्किल्स पर वापस
aider-nix
matko द्वारा
Aider—अभी तक कोई रेटिंग नहीं
आपकी रेटिंग
संक्षिप्त
alternative nix-packaging for aider-chat
विवरण
# aider-nix: alternative nix packaging for aider-chat
This provides an alternative nix packaging for [aider-chat](https://aider.chat/). Although aider-chat is in nixpkgs, its packaging depends on the standard python packaging practices of nixpkgs, which means all dependencies must be part of nixpkgs already, in a compatible version for aider-chat to make use of.
This project instead packages aider-chat using [pyproject.nix](https://github.com/pyproject-nix/pyproject.nix) and [uv2nix](https://github.com/pyproject-nix/uv2nix), using my own [uvpart](https://github.com/matko/uvpart) flake-part wrappers to make this a little easier for myself. This is much more like what you'd get if you were to pipx-install, but still nixified, with all the reproducible-buildy goodness that comes with that.
As a result, it's easier, in principle, to keep this up to date with upstream aider-chat. Whether or not I'll actually keep it updated though will depend on my available time and whether or not I'll actually keep using aider.
Another big advantage is that unlike the version in nixpkgs, this packaging of aider-chat is able to run python code within a virtual environment. The nixpkgs packaging unfortunately wraps aider-chat in such a way that if aider-chat itself runs python, it'll use the python binary that aider-chat itself uses, which completely ignores the virtual environment you may have started aider-chat in. As a result, running any scripts or tests through aider-chat will likely result in missing packages errors. The version from aider-nix on the other hand doesn't hide the virtual environment, and therefore is able to call python project code without any issues.
## Try it out
Assuming you have nix installed, and have enabled the `nix-command` and `flakes` experimental features, you should just be able to run
```bash
nix run github:matko/aider-nix
```
## Install
This project exposes aider-chat as a flake package. If you use nix profiles you can install it with
```bash
nix profile install github:matko/aider-nix
```
If you use a flake-based home-manager or system configuration, You can add this flake as an extra input, and get `aider-chat` from the exposed package set.
## Optional Features
This package supports several optional features that can be enabled as needed:
- **Browser support**: Enables web browsing capabilities
- **Help features**: Adds additional help documentation
- **Playwright support**: Adds support for browser automation with Playwright
- **All features**: Enables all optional features at once
You can enable these features when using the package directly or through the Home Manager module.
### Using with Nix Run or Profile Install
To use aider with specific features enabled:
```bash
# Run with all features enabled
nix run github:matko/aider-nix#aider-chat-full
# Install with all features enabled
nix profile install github:matko/aider-nix#aider-chat-full
```
### Using in a Flake
When importing the package in your own flake, you can override the package to enable specific features:
```nix
aider-chat = aider-nix.packages.${system}.aider-chat.override {
withBrowser = true;
withHelp = true;
# Other options: withPlaywright, withAllFeatures
};
```
## Home Manager Module
This project includes a Home Manager module that allows you to easily install aider and configure it with a `.aider.conf.yml` file in your home directory.
### Usage
Add the flake to your Home Manager configuration:
```nix
{
inputs = {
# ... your other inputs
aider-nix.url = "github:matko/aider-nix";
};
outputs = { self, nixpkgs, home-manager, aider-nix, ... }: {
# ... your other outputs
homeConfigurations = {
"yourusername" = home-manager.lib.homeManagerConfiguration {
# ... your other configuration
modules = [
aider-nix.homeManagerModules.default
{
programs.aider = {
enable = true;
# Optional features
enableBrowser = true;
enableHelp = true;
# enablePlaywright = true;
# enableAllFeatures = true;
settings = {
# Your aider configuration
model = "gpt-4";
edit_format = "diff";
auto_commits = false;
# Add any other settings you want in your .aider.conf.yml
};
};
}
];
};
};
};
}
```
### Configuration Options
The module provides the following options:
- `enable`: Boolean to enable/disable aider (default: false)
- `package`: The aider package to use (defaults to the package in this project, but you can override this with pkgs.aider-chat or similar if you like)
- `enableAllFeatures`: Boolean to enable all optional features (default: false)
- `enableBrowser`: Boolean to enable browser support (default: false)
- `enableHelp`: Boolean to enable help features (default: false)
- `enablePlaywright`: Boolean to enable playwright support (default: false)
- `settings`: Configuration for aider, written to ~/.aider.conf.yml
### Example Configuration
Here's an example of a more complete configuration:
```nix
programs.aider = {
enable = true;
enableBrowser = true;
enableHelp = true;
settings = {
model = "gpt-4-turbo";
temperature = 0.0;
edit_format = "simple";
auto_commits = false;
context_window = 32000;
max_tokens = 4000;
openai_api_base = "https://api.openai.com/v1";
# You can add your API key here, but it's better to use environment variables.
# IMPORTANT: secrets included here will go unencrypted into your nix store!!
# openai_api_key = "your-api-key";
};
};
```
Note: It's generally better to set your API key as an environment variable rather than in the configuration file. Any secrets included here (even if commented out) will go unencrypted into your nix store, and they'll be readable to any user on your system or any system where the resulting nix closure gets copied to.
इंस्टॉलेशन
https://github.com/matko/aider-nix से यह स्किल इंस्टॉल करोयह स्किल ClawHub रजिस्ट्री पर पब्लिश नहीं है। प्रॉम्प्ट को अपने कोडिंग एजेंट — Claude Code, Cursor, Codex — में पेस्ट करें, और वह स्किल को सीधे सोर्स रिपॉज़िटरी से इंस्टॉल कर देगा।
रिपॉज़िटरी खोलें