vbc1406

Flux OS — AI skill for Claude Code

AI community

Send every LLM request to the cheapest model that can handle it.

How to install Flux OS

This entry records only its repository, not the path inside it, so there is no exact command to give. Open vbc1406/flux-os and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Flux OS does

Send every LLM request to the cheapest model that can handle it. Drop-in OpenAI + Anthropic compatible router for agents and wrappers.

Alternatives in AI

  • WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★
  • Vllm Mlx — High-performance OpenAI and Anthropic compatible LLM inference server for Apple Silicon 1.5k ★
  • Claude To ChatGPT — This project converts the API of Anthropic's Claude model to the OpenAI Chat API format 1.3k ★

README

flux-os

**Send every LLM request to the cheapest model that can actually handle it.**

A drop-in router for the OpenAI and Anthropic APIs. Works with agents and wrappers, as a proxy or a Python library. No dashboard, no database, no setup.

[![CI](https://github.com/vbc1406/flux-os/actions/workflows/ci.yml/badge.svg)](https://github.com/vbc1406/flux-os/actions/workflows/ci.yml) ![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue) ![License](https://img.shields.io/badge/license-MIT-green)

"hi"                                          → gpt-oss-20b      (groq)     ~$0.00004
"Translate 'good morning' into Spanish"       → mistral-small-4  (mistral)  ~$0.0002
"Write a Python function that parses dates"   → gpt-oss-20b      (groq)     ~$0.0004
"Implement a lock-free concurrent hash map in
 Rust, thread-safe, no global locks, ..."     → o4-mini          (openai)   ~$0.0053

Most traffic doesn't need your most expensive model. flux-os reads each request (task type, difficulty, tools, images, JSON mode, context size), sets a quality bar, and picks the **cheapest model that clears it**. If that model fails (rate limit, outage, timeout), the request is **rerouted** to the next-best model, on a different provider first.

  • Zero code changes. Point your OpenAI or Anthropic client at flux-os and set model="auto".
  • Agents work. Tool calls, streaming tool calls, and multi-turn tool loops work across every provider, whichever API format your framework speaks.
  • Three API formats in, any provider out. Chat Completions, the Responses API and Anthropic Messages, translated to OpenAI, Anthropic, Gemini, Groq, Mistral, DeepSeek, OpenRouter, Ollama or any OpenAI-compatible server.
  • Fast. Pure-Python heuristics, no LLM in the decision path, well under 1 ms per decision.

Quickstart

pip install "git+https://github.com/vbc1406/flux-os"

# See what it would do. No API keys