Is OmniRoute still maintained?

Yes, active. Last change today. Latest release v3.8.53, yesterday.

Can I trust OmniRoute?

Some track record. 85k stars, 9 months old, by an organization. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install OmniRoute on Linux (cheaper-inference/OmniRoute) · gitmanual

How to install on Linux

cheaper-inference/OmniRoute

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

Node.jsNext.js#a2a#ai-agents#ai-gateway#anthropic

Difficulty: Involved
Time: 30 min or more
Stars: ★ 85,294
Activity: Updated this month
License: MIT
Open issues: 570
Got it running: Be the first
Looked up: 10 h ago

Saved setup from 10 h ago

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change today. Latest release v3.8.53, yesterday.
Can I trust it?: Some track record85k stars, 9 months old, by an organization. Get it from the official repo and read what it installs.

Start here

Website ↗omniroute.onlineThe project's own site.

Will it work on my device?

Yes, it installs on your Linux

A ready-made Linux download is in the latest release.

Checking for

macOS Windows Linux

Download for Linux

v3.8.53 · 11/6/2026 ↗

OmniRoute-3.8.53.AppImage

AppImage · 417.5 MB · 154 downloads · best match

Download

curl -LO "https://github.com/cheaper-inference/OmniRoute/releases/download/v3.8.53/OmniRoute-3.8.53.AppImage"
chmod +x "OmniRoute-3.8.53.AppImage"
./"OmniRoute-3.8.53.AppImage"

Other Linux downloads (3)

omniroute-desktop_3.8.53_amd64.deb

deb · x64 · 310.6 MB · 50 downloads

Download

curl -LO "https://github.com/cheaper-inference/OmniRoute/releases/download/v3.8.53/omniroute-desktop_3.8.53_amd64.deb"
sudo apt install ./"omniroute-desktop_3.8.53_amd64.deb"

OmniRoute-3.8.53-arm64.AppImage

AppImage · ARM64 · 418.8 MB · 16 downloads

Download

curl -LO "https://github.com/cheaper-inference/OmniRoute/releases/download/v3.8.53/OmniRoute-3.8.53-arm64.AppImage"
chmod +x "OmniRoute-3.8.53-arm64.AppImage"
./"OmniRoute-3.8.53-arm64.AppImage"

omniroute-desktop_3.8.53_arm64.deb

deb · ARM64 · 305.6 MB · 12 downloads

Download

curl -LO "https://github.com/cheaper-inference/OmniRoute/releases/download/v3.8.53/omniroute-desktop_3.8.53_arm64.deb"
sudo apt install ./"omniroute-desktop_3.8.53_arm64.deb"

Install with a package manager

npm

npm install -g omniroute

npm

npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute

npm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

AUR

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

npm

bun install -g omniroute

npm

bun add -g omniroute

From the README, exactly as the maintainers wrote it.

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

Docker

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40  -e OMNIROUTE_MEMORY_MB=8192 --memory=10g  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for Linux yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24runtime
1×Docker tool
1×npm package manager
1×Redis service
1×Vector DB service

27× settings in .env

ENABLE_LIVE_DEVIN_TESTS
DEVIN_BRIDGE_MODEL
DEVIN_BRIDGE_SONNET_MODEL
DEVIN_BRIDGE_OPUS_MODEL
DEVIN_BRIDGE_HAIKU_MODEL
DEVIN_BRIDGE_SUBAGENT_MODEL
DASHBOARD_PORT
API_PORT
LIVE_WS_PORT
APP_BIND_HOST
REQUIRE_API_KEYsecret
OMNIROUTE_MEMORY_MB
OMNIROUTE_IMAGE
OMNIROUTE_BIND_HOST
OMNIROUTE_PORT
JWT_SECRETsecret
API_KEY_SECRETsecret
OMNIROUTE_WS_BRIDGE_SECRETsecret
INITIAL_PASSWORDsecret
OMNIROUTE_MEMORY_LIMIT
OMNIROUTE_CPUS
OMNIROUTE_PIDS_LIMIT
APP_LOG_LEVEL
HOMOLOG_BASE_URL
HOMOLOG_ADMIN_PASSWORDsecret
HOMOLOG_API_KEYsecret
HOMOLOG_CRITICAL_PROVIDERS

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/cheaper-inference/OmniRoute/badge.svg)](https://gitmanual.com/cheaper-inference/OmniRoute)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: node:26.12.1-trixie-slim).
Makefile has a make install target — it may automate most of these steps.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: @omniroute/opencode-plugin-v2/package.json, @omniroute/opencode-plugin/package.json, @omniroute/opencode-provider/package.json, electron/package.json and 5 more

package.json scripts (233)

devnode --max-old-space-size=8192 scripts/dev/run-next.mjs dev
dev:candidatenode scripts/dev/candidate.mjs
prebuild:docsnode scripts/docs/gen-openapi-module.mjs
gen:provider-referencebun scripts/docs/gen-provider-reference.ts
gen:public-openapinode scripts/build/publicOpenApi.mjs
gen:i18n-routesnode scripts/i18n/generate-route-namespaces.mjs
bench:compressionbun scripts/compression/benchmark.ts
bench:heap-bodynode --expose-gc --import tsx/esm scripts/perf/request-body-heap.ts
bench:routing-eventsnode --import tsx/esm scripts/perf/routing-events-bench.ts
bench:egress-quota-rotationnode --import tsx/esm scripts/perf/egress-quota-rotation-bench.ts
bench:highwatermarknode --import tsx/esm scripts/perf/benchmark-highwatermark.ts
perf:lts-baselinenode scripts/perf/lts-baseline.mjs
eval:compressionnode --import tsx scripts/compression-eval/index.ts
eval:routernode --import tsx scripts/router-eval/index.ts
eval:router:comparenode --import tsx scripts/router-eval/compare.ts
eval:router:patch-comparenode --import tsx scripts/router-eval/patch-compare.ts
eval:router:searchnode --import tsx scripts/router-eval/search.ts
eval:router:trendsnode --import tsx scripts/router-eval/trends.ts
release:sync-changelog-i18nnode scripts/release/sync-changelog-i18n.mjs
prebuildnpm run check:native-deps
prebuild:fastnpm run check:native-deps
buildnode scripts/build/build-next-isolated.mjs
build:fastcross-env OMNIROUTE_SKIP_STANDALONE=1 node scripts/build/build-next-isolated.mjs
build:secureOMNIROUTE_BUILD_PROFILE=minimal node scripts/build/build-next-isolated.mjs
build:backendcross-env OMNIROUTE_BUILD_BACKEND_ONLY=1 node scripts/build/build-next-isolated.mjs

Files we read (19)

.env.devin-bridge.example

.env.homolog.example

.env.selfhost.example

.github/workflows/api-route-typecheck.yml

.github/workflows/base-ci-repair.yml

.github/workflows/build.yml

.github/workflows/ci.yml

.github/workflows/nightly-v4-build.yml

.github/workflows/opencode-plugin-ci.yml

.node-version

.nvmrc

CONTRIBUTING.md

Dockerfile

Makefile

README.md

contrib/vps/.env.example

docker-compose.yml

package.json

pnpm-workspace.yaml

Branch release/v3.8.54 · 27,797 files in the repo