Lynkr

Use Lynkr with Eden AI to route your gateway to 500+ AI models with tier-based cost optimisation.

Overview

Lynkr is an open-source LLM gateway that cuts costs with tier-based routing — it scores each request 0–100 and sends it to the cheapest model that can handle it. Eden AI is a built-in Lynkr provider, so you reach models from OpenAI, Anthropic, Google, Mistral and 500+ more behind one key, with EU-based, GDPR-aligned inference and unified billing.

Installation

npm install -g lynkr

brew tap fast-editor/lynkr
brew install lynkr

curl -fsSL https://raw.githubusercontent.com/Fast-Editor/Lynkr/main/install.sh | bash

Quick Start

Initialise Lynkr, point it at Eden AI, and start the gateway:

lynkr init                       # scaffold a .env
export EDENAI_API_KEY=your-edenai-key
export MODEL_PROVIDER=edenai      # send all requests to Eden AI
lynkr start                       # OpenAI-compatible endpoint on port 8081

curl

curl -X POST http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral/mistral-small-2603",
    "messages": [{"role": "user", "content": "Hello from Lynkr + Eden AI"}]
  }'

Configuration

Lynkr reads provider credentials from environment variables (or a .env file):

EDENAI_API_KEY=your-edenai-key
EDENAI_MODEL=openai/gpt-5-mini                       # default model (provider/model naming)
EDENAI_EMBEDDINGS_MODEL=openai/text-embedding-ada-002
EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions

Routing modes

Static — every request goes to Eden AI:

export MODEL_PROVIDER=edenai

Tier-based (recommended for cost) — set all four tiers to Eden AI models; Lynkr routes by request complexity:

export TIER_SIMPLE=edenai:mistral/mistral-small-2603
export TIER_MEDIUM=edenai:openai/gpt-5-mini
export TIER_HARD=edenai:anthropic/claude-sonnet-5
export TIER_EXPERT=edenai:openai/gpt-5.5

Available Models

Use the provider/model format for any Eden AI model: OpenAI

openai/gpt-5.5
openai/gpt-5-mini

Anthropic

anthropic/claude-sonnet-5
anthropic/claude-haiku-4-5

Google

google/gemini-2.5-pro
google/gemini-3.5-flash

Mistral

mistral/mistral-large-2512
mistral/mistral-small-2603

Environment Variables

EDENAI_API_KEY=your_api_key_here
EDENAI_MODEL=openai/gpt-5-mini
EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions

Next Steps

Chat Completions - Core LLM endpoint
List LLM Models - Browse available providers and models
OpenAI SDK (Python) - Direct SDK usage

V3 Documentation

Quick Start

Overview

LLMs

Expert Models

General

Organization

Data Governance

Integrations

Overview

Installation

Quick Start

Configuration

Routing modes

Available Models

Environment Variables

Next Steps

​Overview

​Installation

​Quick Start

​Configuration

​Routing modes

​Available Models

​Environment Variables

​Next Steps

Overview

Installation

Quick Start

Configuration

Routing modes

Available Models

Environment Variables

Next Steps