Production-ready Aider configuration optimized for free-tier LLMs (Gemini, DeepSeek R1) with model aliasing, repo map tokens, dark mode, and custom conventions file support.
A battle-tested Aider configuration from quanhua92's dotfiles that prioritizes free-tier LLMs while maintaining professional development workflows.
This configuration sets up Aider with:
When a user requests this Aider setup, follow these steps:
Create `.aider.conf.yml` in the user's home directory or project root with this structure:
```yaml
model: free-r1
editor-model: free-2.5-pro
weak-model: gemini/gemini-2.0-flash-exp
alias:
- free-2.5-pro:gemini/gemini-2.5-pro-exp-03-25
- free-2.0:gemini/gemini-2.0-flash-exp
- free-optimus:openrouter/openrouter/optimus-alpha
- free-r1:openrouter/deepseek/deepseek-r1:free
map-tokens: 4096
dark-mode: true
show-diffs: true
show-model-warnings: false
auto-commits: false
subtree-only: true
analytics-disable: true
read: ~/CONVENTIONS.md
```
**Primary Models (Free Tier):**
**Commented Alternatives:**
Users can uncomment these for different performance/cost profiles:
Ensure required API keys are configured:
```bash
export GEMINI_API_KEY="your-key"
export OPENROUTER_API_KEY="your-key"
```
If the user wants coding conventions:
1. Create `~/CONVENTIONS.md` with project-specific rules
2. Aider will automatically read this file on startup
3. Example conventions file:
```markdown
```
**Repo Map (4096 tokens):**
**Subtree-Only Mode:**
**Manual Commits:**
```bash
aider
aider --model free-2.5-pro
aider --editor-model gemini/gemini-2.0-flash-exp
aider --map-tokens 0
```
1. **Free R1 as Default**: DeepSeek R1 provides reasoning capabilities at zero cost
2. **Gemini for Editing**: 2.5 Pro Exp offers good code quality for structural changes
3. **4096 Map Tokens**: Balances context vs. speed for medium-sized repos
4. **Manual Commits**: Professional workflow for production environments
5. **Analytics Disabled**: Privacy-first configuration
**For Different Model Preferences:**
**For Monorepos:**
**For Solo Projects:**
**For Auto-Commit Workflows:**
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/aider-ai-coding-assistant-configuration/raw