Skip to content

Reading the repo

Opening the box…

How to install freellmapi on macOS (tashfeenahmed/freellmapi) · gitmanual

How to install on macOS

tashfeenahmed/freellmapi

7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.

Node.js

Difficulty: Easy
Time: about 5 min
Stars: ★ 48,449
Activity: Updated this month
License: MIT
Open issues: 47
Got it running: Be the first
Looked up: 11 h ago

Saved setup from 11 h ago

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change yesterday. Latest release v0.16.20, yesterday.
Can I trust it?: Widely used48k stars. As with any download, get it from the official repo.

Start here

Website ↗freellmapi.coThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

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

Supported devices from the README: Compatible CLIs & coding agents

<div align="center"> <table> <tr> <td align="center" width="150"><img src="repo-assets/agents/claude-code.png" width="44" alt="Claude Code"><br/><b>Claude Code</b></td> <td align="center" width="150"><img src="repo-assets/agents/codex.png" width="44" alt="Codex CLI"><br/><b>Codex CLI</b></td> <td align="center" width="150"><img src="repo-assets/agents/gemini-cli.png" width="44" alt="Gemini CLI"><br/><b>Gemini CLI</b></td> <td align="center" width="150"><img src="repo-assets/agents/cursor.png" width="44" alt="Cursor"><br/><b>Cursor</b></td> </tr> <tr> <td align="center"><img src="repo-assets/agents/cline.png" width="44" alt="Cline"><br/><b>Cline</b></td> <td align="center"><img src="repo-assets/agents/roo-code.png" width="44" alt="Roo Code"><br/><b>Roo Code</b></td> <td align="center"><img src="repo-assets/agents/opencode.png" width="44" alt="OpenCode"><br/><b>OpenCode</b></td> <td align="center"><img src="repo-assets/agents/aider.png" width="44" alt="Aider"><br/><b>Aider</b></td> </tr> </table>

<i>… plus Continue, Goose, Qwen Code, Kilo Code, Crush, Zed, JetBrains AI, DeepSeek Harness, MiMo Code, AtomCode, OpenClaw, Hermes Agent, Pi, Reasonix, ZCode and any OpenAI-compatible, Anthropic, Gemini or Ollama client</i>

</div>

Most agents configure themselves with one command that reads your live catalog, backs up the existing config and merges into it:

npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>

All supported agents and their setup commands → · Per-tool recipes, MCP server and URL tokens →

Checking for

macOS Windows Linux

Download for macOS

v0.16.20 — FreeModel BYOK support · 11/6/2026 ↗

FreeLLMAPI-0.16.20-arm64.dmg

dmg · Apple Silicon · 126.8 MB · 1,600 downloads · best match

Drag the app into Applications.

curl -LO "https://github.com/tashfeenahmed/freellmapi/releases/download/v0.16.20/FreeLLMAPI-0.16.20-arm64.dmg"
open "FreeLLMAPI-0.16.20-arm64.dmg"

Other macOS downloads (1)

FreeLLMAPI-0.16.20-x64.dmg

dmg · Intel · 135.7 MB · 248 downloads

Drag the app into Applications.

curl -LO "https://github.com/tashfeenahmed/freellmapi/releases/download/v0.16.20/FreeLLMAPI-0.16.20-x64.dmg"
open "FreeLLMAPI-0.16.20-x64.dmg"

Install with a package manager

install script

curl -fsSL https://freellmapi.co/install.sh | bash

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

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

Ask Claude Ask ChatGPT

Parts list

1×Node.js 22runtime
1×npm package manager

4× settings in .env

ENCRYPTION_KEYsecretoptional
PORT
REQUEST_ANALYTICS_RETENTION_DAYS
REQUEST_ANALYTICS_MAX_ROWS

Share this manual

Is this your repo?

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

[![Setup manual](https://gitmanual.com/tashfeenahmed/freellmapi/badge.svg)](https://gitmanual.com/tashfeenahmed/freellmapi)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: ${NODE_IMAGE}).
Nested projects: cli/package.json, client/package.json, desktop/package.json, server/package.json and 1 more

package.json scripts (19)

devconcurrently --kill-others-on-fail --names server,client "npm run dev -w server" "npm run dev -w client"
dev:lanconcurrently --kill-others-on-fail --names server,client "npm run dev -w server" "npm run dev -w client -- --host"
testnpm run test:bootstrap && npm run test:hooks && npm run test -w server && npm run test -w cli && npm run test -w client --if-present
test:bootstrapnode --test scripts/dev-bootstrap.test.mjs
test:hooksnode --test .claude/hooks/contributing-check.test.mjs
buildnpm run build -w server && npm run build -w cli && npm run build -w client
lintnpm run lint -w server && npm run lint -w cli
build:servernpm run build -w server
test:migrationsnpm run test:migrations -w server
desktop:devnpm run build -w client && npm --prefix desktop run dev
desktop:distnpm run build -w client && npm --prefix desktop run dist
desktop:dist:mac:x64npm run build -w client && npm --prefix desktop run dist:mac:x64
desktop:dist:winnpm run build -w client && npm --prefix desktop run dist:win
desktop:dist:linuxnpm run build -w client && npm --prefix desktop run dist:linux
db:migration:upnpm run db:migration:up -w server
db:migration:downnpm run db:migration:down -w server
db:migration:freshnpm run db:migration:fresh -w server
db:migration:statusnpm run db:migration:status -w server
db:migration:createnpm run db:migration:create -w server

Files we read (11)

.env.example

.github/workflows/ci.yml

.github/workflows/cli-release.yml

.github/workflows/desktop-release.yml

.github/workflows/docker.yml

.nvmrc

Dockerfile

README.md

docker-compose.yml

docs/install.md

package.json

Branch main · 1,315 files in the repo