docs: Add FuturMix as a remote model provider

[FuturMix]

Summary

Add comprehensive documentation for integrating FuturMix with Jan Desktop, enabling users to access 22+ AI models from multiple providers through a single OpenAI-compatible API.

Changes

• New file: docs/src/pages/docs/desktop/remote-models/futurmix.mdx - Complete integration guide
• Updated: docs/src/pages/docs/desktop/remote-models/_meta.json - Added FuturMix to navigation menu

Documentation Includes

Setup Instructions

• Step-by-step guide for configuring FuturMix through Jan's OpenAI provider settings
• API key setup process

Model Catalog

Complete list of available models across providers:

• Anthropic: Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Opus, Claude 3 Sonnet, Claude 3 Haiku
• OpenAI: GPT-4, GPT-4o, GPT-4o-mini, GPT-4 Turbo, o1-preview, o1-mini
• Google: Gemini 1.5 Pro, Gemini 1.5 Flash, Gemini 1.0 Pro
• Others: DeepSeek, Llama 3, Mistral, and more

Key Benefits

• High Reliability: 99.99% SLA with automatic failover
• Cost-Effective: Competitive enterprise pricing
• OpenAI Compatible: Seamless integration with Jan's existing infrastructure

Troubleshooting

Comprehensive guide covering:

• API key configuration issues
• Connection problems
• Model availability checks
• Authentication errors

About FuturMix

FuturMix is a multi-model AI API hub that simplifies access to multiple AI model providers. By using an OpenAI-compatible API, it integrates seamlessly with Jan Desktop while providing access to a wide range of models with high reliability and competitive pricing.

Format & Style

This documentation follows the same structure and style as existing provider pages (OpenRouter, Groq, Anthropic) to ensure consistency with Jan's documentation standards. It uses the same Nextra components and follows established patterns for settings navigation and model configuration.

Testing

The integration has been verified to work with Jan Desktop by configuring the OpenAI provider with the custom FuturMix endpoint.

---

🤖 Generated with Claude Code

[tokamak-pm]

Code Review

Summary: Adds documentation for integrating FuturMix AI Gateway as a remote model provider in Jan. Includes a new MDX page with setup instructions, available models list, and troubleshooting tips, plus a navigation entry in _meta.json.

Findings:

• Promotional content concern: The documentation reads more like marketing material than a neutral integration guide. Phrases like "99.99% SLA", "20-30% cheaper than alternative gateways", and the "Benefits" section are promotional claims that don't belong in integration docs. Other provider pages in this directory should be checked for consistency -- they likely focus on setup steps without advertising the provider.
• Outdated model list: The listed models include older versions (e.g., Claude 3 Opus, GPT-4 Turbo, o1-preview, Gemini 1.0 Pro) and omit newer ones (e.g., Claude 4 Sonnet/Opus, GPT-4.1, Gemini 2.5). This will become stale quickly. Consider linking to FuturMix's own model list instead of hardcoding it.
• Duplicate heading: "Integrate FuturMix with Jan" appears twice (lines 28 and 36 of the new file).
• No code changes: This is docs-only, so no risk to application functionality.
• Contributor is the provider itself: The PR author is "FuturMix", meaning this is a self-submitted provider listing. Maintainers should decide whether this meets the bar for inclusion in official docs.

Recommendation: improve needed -- The duplicate heading should be fixed, the promotional language should be toned down to match the style of other provider docs, and the model list should either be kept minimal or link to an external source to avoid staleness. Maintainers should also decide on the policy for self-submitted provider docs.

[FuturMix]

Thank you for the detailed review! I've pushed a fix (c70de1d) addressing all findings:

• Duplicate heading: Fixed — removed the second "Integrate FuturMix with Jan" heading
• Promotional content: Removed the "Benefits" section entirely, removed SLA/pricing claims from the intro paragraph
• Outdated model list: Replaced with current model IDs (Claude Sonnet 4.5, Opus 4.6, GPT-5.4, Gemini 2.5) + link to external source for the full list, matching the OpenRouter page pattern

The doc now follows the same neutral, setup-focused tone as the OpenRouter integration guide.

[tokamak-pm]

Follow-up Review (c70de1d)

Thanks for the quick turnaround, @FuturMix. Here is where things stand against the original findings:

Finding	Status
Duplicate heading	Fixed -- only one "Integrate FuturMix with Jan" heading now.
Promotional content	Fixed -- "Benefits" section and SLA/pricing claims are gone. The intro paragraph is neutral and comparable in tone to the OpenRouter page.
Outdated model list	Fixed -- model IDs updated to current versions (Claude Sonnet 4.5, Opus 4.6, GPT-5.4, Gemini 2.5 Pro/Flash) and the full list is linked externally to avoid staleness.

Remaining notes (non-blocking):

• The page instructs users to configure via the OpenAI provider with a custom base URL. This is functionally correct but worth a callout: if Jan ever changes how custom OpenAI-compatible endpoints are handled, this page would need updating. A brief note like "FuturMix works through Jan's OpenAI provider because it exposes an OpenAI-compatible API" would make the reason clearer to readers. Minor suggestion only.
• The _meta.json insertion places FuturMix between OpenRouter and Hugging Face, which is fine.
• The policy question from the prior review (self-submitted provider docs) is a maintainer decision and outside the scope of this technical review.

All three actionable findings from the first review have been addressed. The page now matches the structure and tone of existing provider docs (OpenRouter, Groq, etc.).

Recommendation: can merge

[FuturMix]

Thanks @tokamak-pm for the thorough review! All three items have been addressed. Would a maintainer be able to merge this when ready?

[tokamak-pm]

🤖 Tokamak Bot — this repository isn't linked to any Tokamak project. A project owner can link it under Project Settings → Repositories, then mention me again.

[FuturMix]

The review feedback has been fully addressed and the reviewer confirmed 'can merge.' Could a maintainer from the Jan team please review and merge? Thank you!

[FuturMix]

Hi maintainers — just a gentle follow-up. The automated review confirmed all findings were addressed and recommended merging. This is a docs-only PR adding FuturMix as an OpenAI-compatible provider option. Would appreciate a quick review when you get a chance. Thank you!

[tokamak-pm]

Review: docs: Add FuturMix AI Gateway as a remote model provider

Summary: Adds a docs page for FuturMix AI Gateway as a remote model provider, accessible via Jan's existing OpenAI-compatible provider settings. Docs-only change (2 files: new MDX page + _meta.json update).

Positive observations

• Follows the established docs structure for remote model providers.
• Instructions correctly direct users to configure the OpenAI provider with a custom base URL, which is the right approach for an OpenAI-compatible gateway.
• Troubleshooting section is comprehensive.

Issues and observations

1. Model IDs may be outdated. The example model IDs reference specific model versions (e.g., claude-sonnet-4-5-20250929, gpt-5.4). These will become stale. Consider either linking to FuturMix's own model catalog page instead of hardcoding IDs, or adding a note that users should check the FuturMix site for current model IDs.
2. No first-party provider integration. Unlike the Perplexity PR (feat: add Perplexity as a cloud model provider #8103) which adds a dedicated provider entry, this PR only adds docs for using FuturMix through the generic OpenAI provider. That is a reasonable approach for a third-party gateway, but the docs should make it clearer that this is not a built-in provider -- users configure it through the OpenAI provider settings with a custom base URL.
3. Prior reviews were addressed. The author has addressed all feedback from earlier review rounds (duplicate heading, promotional content, model list accuracy). The previous review recommended merge.

Recommendation: can merge

[tokamak-pm]

Review Status Check (2026-06-06)

No new commits or changes since the last review on 2026-05-01. The PR remains in the same state (2 commits: 73d6963 initial + c70de1d fixes).

Prior review history:

• Round 1 (2026-04-26): Found duplicate heading, promotional content, and outdated model list. Recommended improve needed.
• Round 2 (2026-04-27): All three findings were addressed. Recommended can merge.
• Round 3 (2026-05-01): Re-confirmed docs-only change follows established patterns. Recommended can merge.

Current assessment: The two changed files (new futurmix.mdx + _meta.json navigation entry) are docs-only with no application risk. The page matches the structure and tone of existing provider docs. All prior review feedback has been addressed.

This PR has been waiting for maintainer action for over five weeks. The only remaining decision is the policy question of whether self-submitted provider documentation meets the bar for inclusion in official docs -- that is a maintainer call, not a code review issue.

Recommendation: can merge