Package Exports

unified-ai-router
unified-ai-router/main.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (unified-ai-router) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Unified AI Router

A unified interface for multiple LLM providers with automatic fallback. Send one request to multiple AI models simultaneously.

🚀 Features
🛠️ Installation
📖 Usage
- 📚 Basic Library Usage
- 🤖 Telegram Bot Deployment
🔧 Supported Providers
🔑 API Keys
🔼 Vercel Deployment (Telegram Bot)
📁 Project Structure
📄 License

🚀 Features

Multi-Provider Support: Works with OpenAI, Google, Grok, OpenRouter, Z.ai, Qroq, Cohere, Vercel, Cerebras, and LLM7
Automatic Fallback: If one provider fails, automatically tries the next
Simple API: Easy to use interface for all supported providers

🛠️ Installation

npm i unified-ai-router
git clone https://github.com/mlibre/AIRouter
cd AIRouter
npm i

📖 Usage

📚 Basic Library Usage

This is the core AIRouter library - a JavaScript class that provides a unified interface for multiple LLM providers.

const AIRouter = require("./main");
require("dotenv").config();

const providers = [
  {
    name: "openai",
    apiKey: process.env.OPENAI_API_KEY,
    model: "gpt-4",
    apiUrl: "https://api.openai.com/v1"
  },
  {
    name: "google",
    apiKey: process.env.GOOGLE_API_KEY,
    model: "gemini-2.5-pro",
    apiUrl: "https://generativelanguage.googleapis.com/v1beta/openai/"
  }
];

const llm = new AIRouter(providers);

const messages = [
  { role: "system", content: "You are a helpful assistant." },
  { role: "user", content: "Explain quantum computing in simple terms." }
];

const response = await llm.chatCompletion(messages, {
  temperature: 0.7
});

console.log(response);

🤖 Telegram Bot Deployment

For deploying as a Telegram bot, see the Vercel Deployment Guide below. This uses the AIRouter library as the backend for a Telegram bot interface.

🔧 Supported Providers

OpenAI
Google Gemini
Grok
OpenRouter
Z.ai
Qroq
Cohere
Vercel
Cerebras
LLM7

🔑 API Keys

Get your API keys from the following providers:

OpenAI: platform.openai.com/api-keys
Google Gemini: aistudio.google.com/app/apikey
Grok: console.x.ai
OpenRouter: openrouter.ai/keys
Z.ai: api.z.ai
Qroq: console.groq.com/keys
Cohere: dashboard.cohere.com/api-keys
Vercel: vercel.com/docs/ai/ai-gateway
Cerebras: cloud.cerebras.ai
LLM7: token.llm7.io
- Seems like it does not support tool calling

🔼 Vercel Deployment (Telegram Bot)

This section describes how to deploy the AIRouter as a Telegram bot using Vercel. This is a separate deployment from the core library.

📋 Prerequisites

A Telegram Bot Token (@BotFather)
API keys for various AI providers
Vercel account

🚀 Deployment Steps

# Create the vercel project: vercel.com
# name: ai-router

npm i -g vercel
vercel login

nano .env
TELEGRAM_BOT_TOKEN=TOKEN
GOOGLE_API_KEY=API_KEY
OPENROUTER_API_KEY=API_KEY
ZAI_API_KEY=API_KEY
QROQ_API_KEY=API_KEY
COHERE_API_KEY=API_KEY
VERCEL_AI_GATEWAY_API_KEY=API_KEY
CEREBRAS_API_KEY=API_KEY
LLM7_API_KEY=API_KEY
VERCEL_URL=VERCEL_URL
SEARX_URL=SEARX_URL

vercel env add TELEGRAM_BOT_TOKEN
vercel env add GOOGLE_API_KEY
vercel env add OPENROUTER_API_KEY
vercel env add ZAI_API_KEY
vercel env add QROQ_API_KEY
vercel env add COHERE_API_KEY
vercel env add VERCEL_AI_GATEWAY_API_KEY
vercel env add CEREBRAS_API_KEY
vercel env add LLM7_API_KEY
vercel env add VERCEL_URL
vercel env add SEARX_URL

# Deploy to Vercel
vercel
vercel --prod

# Check logs
vercel logs https://ai-router-flame.vercel.app

# Register webhook for Telegram
# https://ai-router-flame.vercel.app/api?register_webhook=true
curl "https://ai-router-flame.vercel.app/api?register_webhook=true"

📱 Enable Telegram Mini App

After deploying the bot, you need to configure the Telegram Mini App and menu button:

Configure Mini App:
- Go to @BotFather
- Send /mybots and select your bot
- Go to Bot Settings → Configure Mini App
- Set the Mini App URL to: https://ai-router-flame.vercel.app
Configure Menu Button:
- Go to @BotFather
- Send /mybots and select your bot
- Go to Bot Settings → Menu Button
- Ensure the URL shown is: https://ai-router-flame.vercel.app

Once configured, users can access the Mini App by sending /start or /app to your bot, or through the menu button.

📁 Project Structure

The Telegram bot deployment uses these files:

api/index.js - Main webhook handler
src/telegram.js - Telegram client implementation
src/config.js - Configuration and provider setup
main.js - The AIRouter library (core functionality)

📄 License

MIT