Skip to content

docs: add MindsHub connection guide - #5608

Open
torrmal wants to merge 1 commit into
Aider-AI:mainfrom
torrmal:add-mindshub-docs
Open

docs: add MindsHub connection guide#5608
torrmal wants to merge 1 commit into
Aider-AI:mainfrom
torrmal:add-mindshub-docs

Conversation

@torrmal

@torrmal torrmal commented Aug 22, 2026

Copy link
Copy Markdown

Summary

Adds a docs page for connecting aider to MindsHub, an OpenAI-compatible inference gateway that fronts Claude, GPT, Kimi, DeepSeek and other models behind one API key and bill.

This is a documentation-only change. Aider's existing generic OpenAI-compatible-API support (OPENAI_API_BASE + OPENAI_API_KEY + the openai/<model> prefix, as already documented in docs/llms/openai-compat.md) already covers MindsHub with zero code changes — I verified this against aider's own openai-compat.md recipe and aider/main.py's handling of --openai-api-base/OPENAI_API_BASE, and against MindsHub's own API docs (https://docs.mindshub.ai/inference/). No new provider abstraction, litellm provider, or model-metadata entry is needed or added.

New file: aider/website/docs/llms/mindshub.md, following the same structure/front-matter as the neighboring openrouter.md and deepseek.md pages (parent: Connecting to LLMs, nav_order: 500, so it's picked up automatically in the sidebar). It covers:

  • Setting OPENAI_API_KEY / OPENAI_API_BASE for MindsHub
  • Using aider --model openai/<alias> with MindsHub's model aliases (sonnet, opus, kimi, deepseek, gpt-codex, etc.)
  • An optional .aider.model.settings.yml snippet
  • A link to the full model catalog and API docs at https://docs.mindshub.ai/inference/

Disclosure

I'm Jorge Torres, affiliated with MindsHub/mindsdb.com (I work there). This PR documents/promotes my own company's product, so flagging that affiliation explicitly here rather than leaving it unstated.

Test plan

  • Confirmed the mechanism this doc describes is fully generic and requires no aider code changes (traced --openai-api-base handling in aider/main.py and the existing openai-compat.md recipe)
  • Verified request/response shapes against MindsHub's own docs (chat-completions.mdx, models.mdx) rather than paraphrasing
  • New page follows the existing docs/llms/*.md front-matter and structure conventions so it appears correctly in the "Connecting to LLMs" nav
  • Not independently re-tested against a live MindsHub key from within aider's test suite (no code paths changed, so no new automated test is applicable)

🤖 Generated with Claude Code

MindsHub (https://mindshub.ai) is an OpenAI-compatible inference gateway
covering Claude, GPT, Kimi, DeepSeek and other models behind one API key.
Aider already talks to it via the existing OPENAI_API_BASE / openai/ prefix
mechanism used for any OpenAI-compatible endpoint, so this adds a docs page
under docs/llms/ (matching openrouter.md/deepseek.md style) with the exact
env vars, model aliases, and a ready-to-use config snippet. No code changes.
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants