Administrator Panel

OmniAI Backend Setup Guide

Complete step-by-step instructions for registering all 8 free API providers and configuring the secure rotating backend server.

✅
6 of 8 API Keys Pre-Loaded
Gemini · Groq · Cerebras · OpenRouter · Cohere · Mistral are configured. Add HuggingFace & Together AI to complete the setup.
8
Free Providers
20K+
Req / Day Free
₹0
Total Cost
~20m
Setup Time

📋 Admin Checklist

track your progress
Setup Progress 0 / 12 tasks done
✓
Sign up for Groq (highest free limit — do this first)
✅ Key configured: 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
✓
Sign up for Google Gemini
✅ Key configured: AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo
✓
Sign up for Together AI
⚠ Not yet configured — api.together.ai → Settings → API Keys
✓
Sign up for OpenRouter
✅ Key configured: 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
✓
Sign up for HuggingFace
⚠ Not yet configured — huggingface.co → Settings → Access Tokens → New Token
✓
Sign up for Cerebras
✅ Key configured: csk-vx8k9xkp3j65tjxwc5rpwydrdjkj56d943fwjn6f3wc5t58y
✓
Sign up for Cohere
✅ Trial key configured: m170vTi3BI1gBLkmcUDIhlYmM3AYfJNimZ6yXdqZ
✓
Sign up for Mistral AI
✅ Key configured: b0a6d206-2c16-422f-af4c-6f4a2ff542ca
✓
Paste all 8 keys into server.js PROVIDER_KEYS section
✅ 6 keys pre-filled in Server Configuration section below. Add HF + Together when ready.
✓
Run cd server && npm install
Installs express, cors, node-fetch, uuid
✓
Start the server with node server.js
Should print "6 providers configured" in terminal
✓
Open public/index.html and verify green "Server online" banner
All provider pills should turn green. Test a query.

🔑 Provider Registration — Step by Step

click each to expand
⚡
Groq
console.groq.com
✓ Configured 14,400 req/day ▼
⭐ Start here. Groq is the fastest, most generous free provider. 14,400 requests/day — enough to power your app solo. Ultra-low latency responses.
🔑 Your active key: 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
1
Open Groq Console
Go to console.groq.com in your browser. Click Sign Up in the top right corner.
2
Create your account
Sign up with Google or email. No credit card required. Verify your email if prompted.
3
Navigate to API Keys
Once logged in, click API Keys in the left sidebar. Then click Create API Key button.
4
Name and copy your key
Name it omniai-server. Click Create. Copy the key immediately — it starts with gsk_ and is only shown once.
5
Paste into server.js
Open server/server.js. Find groq: '' inside PROVIDER_KEYS. Paste your key between the quotes.
🔑 Key format: gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🔷
Google Gemini
aistudio.google.com
✓ Configured 1,500 req/day ▼
🔑 Your active key: AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo
1
Open Google AI Studio
Go to aistudio.google.com. Sign in with your Google account.
2
Get API Key
Click Get API Key button (top left area or header). Then click Create API key in new project.
3
Copy and paste
Copy the generated key. Open server/server.js and paste it into gemini: '' inside PROVIDER_KEYS.
🔑 Key format: AIzaSy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🤝
Together AI
api.together.ai
⚠ Not Yet Set Up ~1,000 req/day ▼
Action needed: This provider is not yet configured. Follow the steps below to get your free key.
1
Sign up at Together AI
Go to api.together.ai. Click Get Started. Sign up with Google or email.
2
Go to API Keys
After login, click your profile icon → Settings → API Keys. Click Create new key.
3
Copy and paste
Copy the key and paste it into together: '' in server.js PROVIDER_KEYS.
Note: Together AI uses Llama-3.3-70B-Instruct-Turbo-Free — a very capable free model with no credit card required.
🔑 Key format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🛣️
OpenRouter
openrouter.ai
✓ Configured ~200 req/day ▼
🔑 Your active key: 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
1
Sign up at OpenRouter
Go to openrouter.ai. Click Sign In → Create account.
2
Create an API Key
Go to Keys section in the dashboard. Click Create Key. Name it omniai.
3
Set credit limit to $0
When creating the key, set the credit limit to $0 so it only uses free models — this prevents any accidental charges.
4
Copy and paste
Copy key and paste into openrouter: '' in server.js.
🔑 Key format: sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🤗
HuggingFace
huggingface.co
⚠ Not Yet Set Up ~500 req/day ▼
Action needed: This provider is not yet configured. Also required for image generation via FLUX.
1
Create HuggingFace account
Go to huggingface.co/join. Fill in username, email, password. Verify email.
2
Go to Access Tokens
Click your profile photo → Settings → Access Tokens in the left menu.
3
Create new token
Click New token. Name it omniai. Select role: Read. Click Generate a token.
4
Copy and paste
Copy the token (starts with hf_). Paste into hf: '' in server.js.
🔑 Key format: hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🧠
Cerebras
cerebras.ai
✓ Configured ~1,000 req/day ▼
🔑 Your active key: csk-vx8k9xkp3j65tjxwc5rpwydrdjkj56d943fwjn6f3wc5t58y
Bonus key available: You also have a second Cerebras key: csk-hjm4ptf8fmx32fxjk5nryjt6jjp2pj5f29pn53ktt3h4ewpd — you can use it as a backup.
1
Sign up at Cerebras
Go to cerebras.ai. Click Get Started or Developer. Create a free account.
2
Navigate to API Keys
In your dashboard, find API Keys section. Click Create new API key.
3
Copy and paste
Copy the key (starts with csk_). Paste into cerebras: '' in server.js.
🔑 Key format: csk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🌊
Cohere
cohere.com
✓ Configured 1,000 req/month ▼
🔑 Your active key (trial): m170vTi3BI1gBLkmcUDIhlYmM3AYfJNimZ6yXdqZ
1
Sign up at Cohere
Go to cohere.com. Click Start for free. Register with email or Google.
2
Get Trial API Key
In your dashboard, click API Keys. You'll see a Trial key already generated. Copy it. No credit card needed.
3
Paste into server.js
Paste the key into cohere: '' in server.js PROVIDER_KEYS.
Note: Cohere trial keys work immediately with no credit card. The 1,000/month limit resets each month — good as a backup provider.
🔑 Key format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🌪️
Mistral AI
console.mistral.ai
✓ Configured ~500 req/day ▼
🔑 Your active key: b0a6d206-2c16-422f-af4c-6f4a2ff542ca
1
Open Mistral Console
Go to console.mistral.ai. Click Sign up. Register with email.
2
Verify and log in
Check email for verification link. Click it, then log in to the console.
3
Create API Key
Go to API Keys in the left sidebar. Click Create new key. Name it omniai.
4
Copy and paste
Copy the key immediately — shown only once. Paste into mistral: '' in server.js.
🔑 Key format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚙ Server Configuration

server/server.js

Open server/server.js — copy this ready-to-use block with your keys pre-filled:

// server/server.js — PROVIDER_KEYS (your keys pre-filled) const PROVIDER_KEYS = { gemini: 'AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo', groq: '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', cerebras: 'csk-vx8k9xkp3j65tjxwc5rpwydrdjkj56d943fwjn6f3wc5t58y', openrouter: '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', cohere: 'm170vTi3BI1gBLkmcUDIhlYmM3AYfJNimZ6yXdqZ', mistral: 'b0a6d206-2c16-422f-af4c-6f4a2ff542ca', hf: '', // ← add your HuggingFace token here (hf_...) together: '', // ← add your Together AI key here };

Then run: node server.js

Pass keys as environment variables — safer since keys aren't saved in code:

# Windows (Command Prompt) set GEMINI_KEY=AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo && set GROQ_KEY=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 && node server.js # Mac / Linux / Git Bash GEMINI_KEY=AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo \ GROQ_KEY=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 \ CEREBRAS_KEY=csk-vx8k9xkp3j65tjxwc5rpwydrdjkj56d943fwjn6f3wc5t58y \ OPENROUTER_KEY=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 \ COHERE_KEY=m170vTi3BI1gBLkmcUDIhlYmM3AYfJNimZ6yXdqZ \ MISTRAL_KEY=b0a6d206-2c16-422f-af4c-6f4a2ff542ca \ HF_KEY=YOUR_HF_TOKEN_HERE \ TOGETHER_KEY=YOUR_TOGETHER_KEY_HERE \ node server.js

Create a file called .env in the server/ folder:

GEMINI_KEY=AIzaSyD7Wax8isGytBCThr10svbi44Ch-MhyyAo# aistudio.google.com
GROQ_KEY=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# console.groq.com
CEREBRAS_KEY=csk-vx8k9xkp3j65tjxwc5rpwydrdjkj56d943fwjn6f3wc5t58y# cerebras.ai
OPENROUTER_KEY=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# openrouter.ai
COHERE_KEY=m170vTi3BI1gBLkmcUDIhlYmM3AYfJNimZ6yXdqZ# cohere.com (trial)
MISTRAL_KEY=b0a6d206-2c16-422f-af4c-6f4a2ff542ca# console.mistral.ai
HF_KEY=hf_YOUR_TOKEN_HERE# huggingface.co — not set yet
TOGETHER_KEY=YOUR_TOGETHER_KEY_HERE# api.together.ai — not set yet

Install dotenv: npm install dotenv then add require('dotenv').config() at the top of server.js. Add .env to your .gitignore so keys never go to GitHub.

🎲 How Rotation Works

auto-fallback flow

Every search request randomly shuffles the provider order. If one fails or is rate-limited, it automatically moves to the next — user never sees an error.

Request In
→
🎲 Shuffle
→
Try Groq
→
✓ Success → Return
Request In
→
🎲 Shuffle
→
Groq limit hit
→
Try Gemini
→
✓ Success
Request In
→
🎲 Shuffle
→
Groq + Gemini down
→
Try Cerebras
→
✓ Success

With 6 configured providers + 2 to add, totalling 20,000+ free requests/day, the app stays online even if multiple providers are down simultaneously.

OmniAI Secure Edition — Admin Setup Guide
6 of 8 providers configured · 2 remaining (HuggingFace, Together AI) · ₹0 total cost
Keep this page bookmarked. Open admin-guide.html anytime as your reference.
API Key Vault
keys → window globals → your page
0/8