🧠 NeuroLink

Universal AI toolkit with multiple provider support, automatic fallback, and both CLI + SDK interfaces. Production-ready with TypeScript support.

NeuroLink unifies OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic, Azure OpenAI, Hugging Face, Ollama, and Mistral AI with intelligent fallback and streaming support. Available as both a programmatic SDK and professional CLI tool. Extracted from production use at Juspay.

🔥 Latest Breakthrough: Full MCP Tool Integration Operational (June 21, 2025)

MAJOR SUCCESS: All blocking TypeScript compilation errors resolved + Complete CLI MCP integration achieved!

✅ Function Calling Ready: AI can now execute real filesystem operations, data analysis, and system commands ✅ Production Validated: 23,230+ token MCP context loading confirmed via comprehensive CLI testing ✅ Zero Build Errors: Clean TypeScript compilation after resolving all 13 blocking errors ✅ CLI Tool Integration: Both generate/gen and agent-generate commands use full MCP capabilities ✅ Backward Compatible: Tools enabled by default with opt-out flag for traditional usage

# NEW: AI can now access your filesystem and execute tools (use preferred commands)
npx @juspay/neurolink generate "List files in this directory" --provider google-ai

# Alternative shorter command
npx @juspay/neurolink gen "List files in this directory" --provider google-ai

# ⚠️ DEPRECATED: generate-text will be removed in v2.0 (use 'generate' or 'gen' instead)
# This command shows a deprecation warning and is kept for backward compatibility only
npx @juspay/neurolink generate-text "List files in this directory" --provider google-ai

🚀 Quick Start

Install & Run (2 minutes)

# Quick setup with Google AI Studio (free tier available)
export GOOGLE_AI_API_KEY="AIza-your-google-ai-api-key"

# CLI - No installation required
npx @juspay/neurolink generate "Hello, AI"
npx @juspay/neurolink gen "Hello, AI"        # Shortest form
npx @juspay/neurolink status

# SDK Installation for using in your typescript projects
npm install @juspay/neurolink

Basic Usage

import { createBestAIProvider } from "@juspay/neurolink";

// Auto-selects best available provider
const provider = createBestAIProvider();
const result = await provider.generateText({
  prompt: "Write a haiku about programming",
});

console.log(result.text);
console.log(`Used: ${result.provider}`);

Environment Setup

# Create .env file (automatically loaded by CLI)
echo 'OPENAI_API_KEY="sk-your-openai-key"' > .env
echo 'GOOGLE_AI_API_KEY="AIza-your-google-ai-key"' >> .env
echo 'AWS_ACCESS_KEY_ID="your-aws-access-key"' >> .env

# Test configuration
npx @juspay/neurolink status

📖 Complete Setup Guide - All providers with detailed instructions

✨ Key Features

• 🔄 9 AI Providers - OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic, Azure, Hugging Face, Ollama, Mistral AI
• ⚡ Dynamic Model System - Self-updating model configurations without code changes
• 💰 Cost Optimization - Automatic selection of cheapest models for tasks
• 🔍 Smart Model Resolution - Fuzzy matching, aliases, and capability-based search
• ⚡ Automatic Fallback - Never fail when providers are down
• 🖥️ CLI + SDK - Use from command line or integrate programmatically
• 🛡️ Production Ready - TypeScript, error handling, extracted from production
• ✅ MCP Integration - Model Context Protocol with working built-in tools and 58+ external servers
• 🔍 MCP Auto-Discovery - Zero-config discovery across VS Code, Claude, Cursor, Windsurf
• ⚙️ Built-in Tools - Time, date calculations, and number formatting ready to use
• 🤖 AI Analysis Tools - Built-in optimization and workflow assistance
• 🏠 Local AI Support - Run completely offline with Ollama
• 🌍 Open Source Models - Access 100,000+ models via Hugging Face
• 🇪🇺 GDPR Compliance - European data processing with Mistral AI

🛠️ MCP Integration Status (v1.11.1) ✅ PRODUCTION READY

✅ Quick MCP Test (v1.7.1)

# Test built-in tools (works immediately)
npx @juspay/neurolink generate "What time is it?" --debug

# Alternative short form
npx @juspay/neurolink gen "What time is it?" --debug

# Test tool discovery
npx @juspay/neurolink generate "What tools do you have access to?" --debug

# Alternative short form
npx @juspay/neurolink gen "What tools do you have access to?" --debug

# Test external server discovery
npx @juspay/neurolink mcp discover --format table
# Shows all discovered MCP servers from Claude, VS Code, Cursor, etc.

⚡ Dynamic Model System (v1.8.0)

NeuroLink now features a revolutionary dynamic model configuration system that eliminates hardcoded model lists and enables automatic cost optimization.

✅ Key Benefits

• 🔄 Self-Updating: New models automatically available without code updates
• 💰 Cost-Optimized: Automatic selection of cheapest models for tasks
• 🔍 Smart Search: Find models by capabilities (function-calling, vision, etc.)
• 🏷️ Alias Support: Use friendly names like "claude-latest" or "best-coding"
• 📊 Real-Time Pricing: Always current model costs and performance data

🚀 Quick Examples

# Cost optimization - automatically use cheapest model
npx @juspay/neurolink generate "Hello" --optimize-cost

# Capability search - find models with specific features
npx @juspay/neurolink generate "Describe this image" --capability vision

# Model aliases - use friendly names
npx @juspay/neurolink gen "Write code" --model best-coding

# Test dynamic model server
npm run model-server  # Starts config server on localhost:3001
npm run test:dynamic-models  # Comprehensive test suite

📊 Current Model Inventory (Auto-Updated)

• 10 active models across 4 providers
• Cheapest: Gemini 2.0 Flash ($0.000075/1K tokens)
• Most capable: Claude 3 Opus (function-calling + vision + analysis)
• Best for coding: Claude 3 Opus, Gemini 2.0 Flash
• 1 deprecated model automatically excluded

📖 Complete Dynamic Models Guide - Setup, configuration, and advanced usage

💻 Essential Examples

CLI Commands

# Text generation with automatic MCP tool detection (default)
npx @juspay/neurolink generate "What time is it?"

# Alternative short form
npx @juspay/neurolink gen "What time is it?"

# Disable tools for training-data-only responses
npx @juspay/neurolink generate "What time is it?" --disable-tools

# Real-time streaming with agent support (default)
npx @juspay/neurolink stream "What time is it?"

# Streaming without tools (traditional mode)
npx @juspay/neurolink stream "Tell me a story" --disable-tools

# Provider diagnostics
npx @juspay/neurolink status --verbose

# Batch processing
echo -e "Write a haiku\nExplain gravity" > prompts.txt
npx @juspay/neurolink batch prompts.txt --output results.json

SDK Integration

// SvelteKit API route
export const POST: RequestHandler = async ({ request }) => {
  const { message } = await request.json();
  const provider = createBestAIProvider();
  const result = await provider.streamText({ prompt: message });
  return new Response(result.toReadableStream());
};

// Next.js API route
export async function POST(request: NextRequest) {
  const { prompt } = await request.json();
  const provider = createBestAIProvider();
  const result = await provider.generateText({ prompt });
  return NextResponse.json({ text: result.text });
}

🎬 See It In Action

No installation required! Experience NeuroLink through comprehensive visual documentation:

📱 Interactive Web Demo

cd neurolink-demo && node server.js
# Visit http://localhost:9876 for live demo

• Real AI Integration: All 9 providers functional with live generation
• Complete Use Cases: Business, creative, and developer scenarios
• Performance Metrics: Live provider analytics and response times
• Privacy Options: Test local AI with Ollama

🖥️ CLI Demonstrations

• CLI Help & Commands - Complete command reference
• Provider Status Check - Connectivity verification (now with authentication and model availability checks)
• Text Generation - Real AI content creation

🌐 Web Interface Videos

• Business Use Cases - Professional applications
• Developer Tools - Code generation and APIs
• Creative Tools - Content creation

📖 Complete Visual Documentation - All screenshots and videos

📚 Documentation

Getting Started

• 🔧 Provider Setup - Complete environment configuration
• 🖥️ CLI Guide - All commands and options
• 🏗️ SDK Integration - Next.js, SvelteKit, React
• ⚙️ Environment Variables - Full configuration guide

Advanced Features

• 🔄 MCP Foundation - Model Context Protocol architecture
• ⚡ Dynamic Models - Self-updating model configurations and cost optimization
• 🧠 AI Analysis Tools - Usage optimization and benchmarking
• 🛠️ AI Workflow Tools - Development lifecycle assistance
• 🎬 Visual Demos - Screenshots and videos

Reference

• 📚 API Reference - Complete TypeScript API
• 🔗 Framework Integration - SvelteKit, Next.js, Express.js

🏗️ Supported Providers & Models

✨ Auto-Selection: NeuroLink automatically chooses the best available provider based on speed, reliability, and configuration.

🎯 Production Features

Enterprise-Grade Reliability

• Automatic Failover: Seamless provider switching on failures
• Error Recovery: Comprehensive error handling and logging
• Performance Monitoring: Built-in analytics and metrics
• Type Safety: Full TypeScript support with IntelliSense

AI Platform Capabilities

• MCP Foundation: Universal AI development platform with 10+ specialized tools
• Analysis Tools: Usage optimization, performance benchmarking, parameter tuning
• Workflow Tools: Test generation, code refactoring, documentation, debugging
• Extensibility: Connect external tools and services via MCP protocol

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

git clone https://github.com/juspay/neurolink
cd neurolink
pnpm install
pnpm setup:complete  # One-command setup with all automation
pnpm test:adaptive   # Intelligent testing
pnpm build:complete  # Full build pipeline

New Developer Experience (v2.0)

NeuroLink now features enterprise-grade automation with 72+ commands:

# Environment & Setup (2-minute initialization)
pnpm setup:complete        # Complete project setup
pnpm env:setup             # Safe .env configuration
pnpm env:backup            # Environment backup

# Testing & Quality (60-80% faster)
pnpm test:adaptive         # Intelligent test selection
pnpm test:providers        # AI provider validation
pnpm quality:check         # Full quality pipeline

# Documentation & Content
pnpm docs:sync             # Cross-file documentation sync
pnpm content:generate      # Automated content creation

# Build & Deployment
pnpm build:complete        # 7-phase enterprise pipeline
pnpm dev:health            # System health monitoring

📖 Complete Automation Guide - All 72+ commands and automation features

📄 License

MIT © Juspay Technologies

🔗 Related Projects

• Vercel AI SDK - Underlying provider implementations
• SvelteKit - Web framework used in this project
• Model Context Protocol - Tool integration standard

Built with ❤️ by Juspay Technologies