@juspay/neurolink 1.3.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # @juspay/neurolink
 
+## 1.5.1
+
+### Patch Changes
+
+- **🔧 Critical CLI Dependency Fix**: Removed peer dependencies to ensure zero-friction CLI usage
+  - **Issue**: CLI commands failed when provider-specific SDK packages were peer dependencies
+  - **Root Cause**: `npx` doesn't install peer dependencies, causing missing module errors
+  - **Solution**: Moved ALL AI provider SDKs to regular dependencies
+  - **Impact**: **100% reliable CLI** - all providers work immediately with `npx @juspay/neurolink`
+  - **Dependencies**: All AI SDK packages now bundled automatically (@ai-sdk/openai, @ai-sdk/bedrock, @ai-sdk/vertex, @ai-sdk/google)
+
+- **📄 Critical Legal Compliance**: Added missing MIT LICENSE file
+  - **Issue**: Package claimed MIT license but had no LICENSE file in repository
+  - **Legal Risk**: Without explicit license file, users had no legal permission to use the software
+  - **Solution**: Added proper MIT License file with Juspay Technologies copyright (2025)
+  - **Impact**: **Full legal compliance** - users now have explicit permission to use, modify, and distribute
+  - **Files**: Added `LICENSE` file with standard MIT license text
+
+### Technical Changes
+
+- **Dependency Structure**: Eliminated peer dependencies entirely for CLI compatibility
+- **Provider Support**: All 5 AI providers (OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic) now work out-of-the-box
+- **Zero Setup**: No manual dependency installation required for any provider
+- **Repository Structure**: LICENSE file now included in package distribution
+- **Legal Clarity**: Explicit copyright and permission statements
+- **Compliance**: Matches industry standards for open source software licensing
+- **Package Files**: LICENSE included in NPM package distribution
+- **Backward Compatibility**: 100% compatible with existing code and configurations
+
+## 1.5.0
+
+### Major Changes
+
+- **🧠 Google AI Studio Integration**: Added Google AI Studio as 5th AI provider with Gemini models
+  - **🔧 New Provider**: Complete GoogleAIStudio provider with Gemini 1.5/2.0 Flash/Pro models
+  - **🆓 Free Tier Access**: Leverage Google's generous free tier for development and testing
+  - **🖥️ CLI Support**: Full `--provider google-ai` integration across all commands
+  - **⚡ Auto-Selection**: Included in automatic provider selection algorithm
+  - **🔑 Simple Setup**: Single `GOOGLE_AI_API_KEY` environment variable configuration
+
+### Features
+
+- **📚 Documentation Architecture Overhaul**: Complete README.md restructuring for better UX
+  - **75% Size Reduction**: Transformed from 800+ lines to ~200 lines focused on quick start
+  - **Progressive Disclosure**: Clear path from basic → intermediate → advanced documentation
+  - **Specialized Documentation**: Created 4 dedicated docs files for different audiences
+  - **Cross-References**: Complete navigation system between all documentation files
+
+### New Documentation Structure
+
+```
+docs/
+├── AI-ANALYSIS-TOOLS.md          # AI optimization and analysis tools
+├── AI-WORKFLOW-TOOLS.md          # Development lifecycle tools
+├── MCP-FOUNDATION.md             # Technical MCP architecture
+└── GOOGLE-AI-STUDIO-INTEGRATION-ARCHIVE.md  # Integration details
+```
+
+### Google AI Studio Provider
+
+```typescript
+// New Google AI Studio usage
+import { createBestAIProvider } from '@juspay/neurolink';
+
+const provider = createBestAIProvider(); // Auto-includes Google AI Studio
+const result = await provider.generateText("Hello, Gemini!");
+```
+
+```bash
+# Quick setup with Google AI Studio (free tier)
+export GOOGLE_AI_API_KEY="AIza-your-google-ai-key"
+npx @juspay/neurolink generate-text "Hello, AI!" --provider google-ai
+```
+
+### Enhanced Visual Content
+
+- **Google AI Studio Demos**: Complete visual documentation for new provider
+- **CLI Demonstrations**: Updated CLI videos showing google-ai provider
+- **Professional Quality**: 6 new videos and asciinema recordings
+
+### Technical Implementation
+
+- **Provider Integration**: `src/lib/providers/googleAIStudio.ts`
+- **Models Supported**: Gemini 1.5 Pro/Flash, Gemini 2.0 Flash/Pro
+- **Authentication**: Simple API key authentication via Google AI Studio
+- **Testing**: Complete test coverage including provider and CLI tests
+
+### Bug Fixes
+
+- **🔧 CLI Dependencies**: Moved essential dependencies (`ai`, `zod`) from peer to regular dependencies
+  - **Issue**: `npx @juspay/neurolink` commands failed due to missing dependencies
+  - **Solution**: CLI now works out-of-the-box without manual dependency installation
+  - **Impact**: Zero-friction CLI usage for all users
+
+### Breaking Changes
+
+- None - 100% backward compatibility maintained
+
 ## 1.4.0
 
 ### Major Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Juspay Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,67 +4,37 @@
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-> Production-ready AI toolkit with multi-provider support, automatic fallback, and full TypeScript integration. **Now with MCP Foundation and professional CLI!**
+> Universal AI toolkit with 5+ provider support, automatic fallback, and both CLI + SDK interfaces. Production-ready with TypeScript support.
 
-**NeuroLink** provides a unified interface for AI providers (OpenAI, Amazon Bedrock, Google Vertex AI) with intelligent fallback, streaming support, and type-safe APIs. Available as both a **programmatic SDK** and a **professional CLI tool**. Extracted from production use at Juspay.
-
-## 🎉 **NEW: MCP Foundation (Model Context Protocol)**
-
-**NeuroLink v1.3.0** introduces a groundbreaking **MCP Foundation** that transforms NeuroLink from an AI SDK into a **Universal AI Development Platform** while maintaining the simple factory method interface.
-
-### **🏆 Phase 1 Complete: 27/27 Tests Passing**
-- ✅ **Factory-First Architecture**: MCP tools work internally, users see simple factory methods
-- ✅ **MCP Compatible**: 99% compatible with existing MCP tools and servers
-- ✅ **Enterprise Ready**: Rich context, permissions, tool orchestration, analytics
-- ✅ **Production Tested**: <1ms tool execution, comprehensive error handling
-
-### **🚀 What This Means for You**
-```typescript
-// Same simple interface you love
-const result = await provider.generateText("Create a React component");
-
-// But now powered by enterprise-grade MCP tool orchestration internally:
-// - Context tracking across tool chains
-// - Permission-based security
-// - Tool registry and discovery
-// - Pipeline execution with error recovery
-// - Rich analytics and monitoring
-```
-
-### **🔧 MCP Architecture**
-- **🏭 MCP Server Factory**: Standard MCP-compatible server creation
-- **🧠 Context Management**: Rich context with 15+ fields + tool chain tracking
-- **📋 Tool Registry**: Discovery, registration, execution + statistics
-- **🎼 Tool Orchestration**: Single tools + sequential pipelines + error handling
-- **🤖 AI Provider Integration**: Core AI tools with schema validation
-
-**Ready for Phase 2**: MCP tool migration enabling unlimited extensibility while preserving the simple interface developers love.
+**NeuroLink** unifies OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic, and Azure OpenAI with intelligent fallback and streaming support. Available as both a **programmatic SDK** and **professional CLI tool**. Extracted from production use at Juspay.
 
 ## 🚀 Quick Start
 
-### 📦 Installation
+### Install & Run (2 minutes)
 
 ```bash
-# CLI Usage (No Installation Required)
+# 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-text "Hello, AI!"
 npx @juspay/neurolink status
+```
 
-# Global CLI Installation
-npm install -g @juspay/neurolink
-neurolink generate-text "Write a haiku about programming"
-
-# SDK Installation
-npm install @juspay/neurolink ai @ai-sdk/amazon-bedrock @ai-sdk/openai @ai-sdk/google-vertex zod
+```bash
+# SDK Installation for using in your typescript projects
+npm install @juspay/neurolink
 ```
 
-### Programmatic Usage
+### Basic Usage
+
 ```typescript
 import { createBestAIProvider } from '@juspay/neurolink';
 
 // Auto-selects best available provider
 const provider = createBestAIProvider();
 const result = await provider.generateText({
-  prompt: "Hello, AI!"
+  prompt: "Write a haiku about programming"
 });
 
 console.log(result.text);
@@ -72,177 +42,59 @@ console.log(`Used: ${result.provider}`);
 ```
 
 ### Environment Setup
+
 ```bash
-# Create .env file (automatically loaded by CLI) ✨ NEW!
-# OpenAI
+# Create .env file (automatically loaded by CLI)
 echo 'OPENAI_API_KEY="sk-your-openai-key"' > .env
-echo 'OPENAI_MODEL="gpt-4o"' >> .env
-
-# Amazon Bedrock
+echo 'GOOGLE_AI_API_KEY="AIza-your-google-ai-key"' >> .env
 echo 'AWS_ACCESS_KEY_ID="your-aws-access-key"' >> .env
-echo 'AWS_SECRET_ACCESS_KEY="your-aws-secret-key"' >> .env
-echo 'AWS_REGION="us-east-1"' >> .env
-echo 'BEDROCK_MODEL="arn:aws:bedrock:region:account:inference-profile/model"' >> .env
 
-# Google Vertex AI
-echo 'GOOGLE_VERTEX_PROJECT="your-project-id"' >> .env
-echo 'GOOGLE_VERTEX_LOCATION="us-central1"' >> .env
-echo 'GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"' >> .env
-
-# Anthropic
-echo 'ANTHROPIC_API_KEY="sk-ant-api03-your-key"' >> .env
-
-# Azure OpenAI
-echo 'AZURE_OPENAI_API_KEY="your-azure-key"' >> .env
-echo 'AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"' >> .env
-echo 'AZURE_OPENAI_DEPLOYMENT_ID="your-deployment-name"' >> .env
-
-# Test configuration (automatically loads .env)
+# Test configuration
 npx @juspay/neurolink status
 ```
 
-**📖 [Complete Environment Variables Guide](./docs/ENVIRONMENT-VARIABLES.md)** - Detailed setup instructions for all providers
-
-## 🎬 Complete Visual Documentation
-
-**No installation required!** Experience NeuroLink's capabilities through our comprehensive visual ecosystem:
-
-### 🌐 Web Demo Screenshots & Videos
-
-#### **📸 Interactive Web Interface Screenshots**
-| Feature | Screenshot | Description |
-|---------|------------|-------------|
-| **Main Interface** | ![Main Interface](./neurolink-demo/screenshots/01-overview/01-main-interface-overview-2025-06-04T13-56-43-628Z.png) | Complete web interface showing all features |
-| **AI Generation Results** | ![AI Generation](./neurolink-demo/screenshots/02-basic-examples/02-ai-generation-results-2025-06-04T13-57-13-156Z.png) | Real AI content generation in action |
-| **Business Use Cases** | ![Business Cases](./neurolink-demo/screenshots/03-business-use-cases/03-business-use-cases-2025-06-04T13-59-07-846Z.png) | Professional business applications |
-| **Creative Tools** | ![Creative Tools](./neurolink-demo/screenshots/04-creative-tools/04-creative-tools-2025-06-04T13-59-24-346Z.png) | Creative content generation |
-| **Developer Tools** | ![Developer Tools](./neurolink-demo/screenshots/05-developer-tools/05-developer-tools-2025-06-04T13-59-43-322Z.png) | Code generation and API docs |
-| **Analytics & Monitoring** | ![Monitoring](./neurolink-demo/screenshots/06-monitoring/06-monitoring-analytics-2025-06-04T14-00-08-919Z.png) | Real-time provider analytics |
-
-#### **🎥 Complete Demo Videos** *(Real AI generation showing SDK use cases)*
-- **[Basic Examples WebM](./neurolink-demo/videos/basic-examples.webm) | [MP4](./neurolink-demo/videos/basic-examples.mp4)** - Core SDK functionality: text generation, streaming, provider selection, status checks
-- **[Business Use Cases WebM](./neurolink-demo/videos/business-use-cases.webm) | [MP4](./neurolink-demo/videos/business-use-cases.mp4)** - Professional applications: marketing emails, quarterly data analysis, executive summaries
-- **[Creative Tools WebM](./neurolink-demo/videos/creative-tools.webm) | [MP4](./neurolink-demo/videos/creative-tools.mp4)** - Content creation: storytelling, translation, blog post ideas
-- **[Developer Tools WebM](./neurolink-demo/videos/developer-tools.webm) | [MP4](./neurolink-demo/videos/developer-tools.mp4)** - Technical applications: React components, API documentation, error debugging
-- **[Monitoring & Analytics WebM](./neurolink-demo/videos/monitoring-analytics.webm) | [MP4](./neurolink-demo/videos/monitoring-analytics.mp4)** - SDK features: performance benchmarks, provider fallback, structured data generation
-
-**Available formats:**
-- **WebM** (web-optimized): All videos available as `.webm` for web embedding
-- **MP4** (universal): All videos available as `.mp4` for desktop and mobile compatibility
-
-### 🖥️ CLI Tool Screenshots & Videos
-
-#### **📸 Professional CLI Screenshots** *(Latest: June 8, 2025)*
-| Command | Screenshot | Description |
-|---------|------------|-------------|
-| **CLI Help Overview** | ![CLI Help](./docs/visual-content/screenshots/cli-screenshots/01-cli-help-2025-06-10T12-00-00.png) | Complete command reference |
-| **Provider Status Check** | ![Provider Status](./docs/visual-content/screenshots/cli-screenshots/02-provider-status-2025-06-10T12-00-00.png) | All provider connectivity verified |
-| **Text Generation** | ![Text Generation](./docs/visual-content/screenshots/cli-screenshots/03-text-generation-2025-06-10T12-00-00.png) | Real AI haiku generation with JSON |
-| **Auto Provider Selection** | ![Best Provider](./docs/visual-content/screenshots/cli-screenshots/04-best-provider-2025-06-10T12-00-00.png) | Automatic provider selection working |
-| **Batch Processing** | ![Batch Results](./docs/visual-content/screenshots/cli-screenshots/05-batch-results-2025-06-10T12-00-00.png) | Multi-prompt processing with results |
-
-#### **🎥 CLI Demonstration Videos** *(Professional H.264 MP4 format)*
-- **[CLI Help & Overview](./docs/visual-content/cli-videos/cli-help.mp4)** (44KB) - Complete command reference and usage examples
-- **[Provider Status Check](./docs/visual-content/cli-videos/cli-provider-status.mp4)** (496KB) - Connectivity testing and response time measurement
-- **[Text Generation](./docs/visual-content/cli-videos/cli-text-generation.mp4)** (100KB) - Real AI content generation with different providers
-- **[MCP Command Help](./docs/visual-content/cli-videos/mcp-help.mp4)** (36KB) - MCP server management commands
-- **[MCP Server Listing](./docs/visual-content/cli-videos/mcp-list.mp4)** (16KB) - MCP server discovery and status
-
-### 🔧 MCP (Model Context Protocol) Visual Documentation
-
-#### **📸 MCP CLI Screenshots** *(Generated Jan 10, 2025)*
-| Command | Screenshot | Description |
-|---------|------------|-------------|
-| **MCP Help Overview** | ![MCP Help](./docs/visual-content/screenshots/mcp-cli/01-mcp-help-2025-06-10.png) | Complete MCP command reference |
-| **Server Installation** | ![Install Server](./docs/visual-content/screenshots/mcp-cli/02-mcp-install-2025-06-10.png) | Installing external MCP servers |
-| **Server Status Check** | ![Server Status](./docs/visual-content/screenshots/mcp-cli/03-mcp-list-status-2025-06-10.png) | MCP server connectivity and status |
-| **Server Testing** | ![Test Server](./docs/visual-content/screenshots/mcp-cli/04-mcp-test-server-2025-06-10.png) | Testing MCP server connectivity |
-| **Custom Server Setup** | ![Custom Server](./docs/visual-content/screenshots/mcp-cli/05-mcp-custom-server-2025-06-10.png) | Adding custom MCP server configurations |
-| **Workflow Integration** | ![Workflow Demo](./docs/visual-content/screenshots/mcp-cli/06-mcp-workflow-demo-2025-06-10.png) | Complete MCP workflow demonstrations |
-
-#### **🎥 MCP Demo Videos** *(Real MCP server integration)*
-- **[Server Management WebM](./neurolink-demo/videos/mcp-demos/mcp-server-management-demo.webm) | [MP4](./neurolink-demo/videos/mcp-demos/mcp-server-management-demo.mp4)** - Installing, configuring, and testing MCP servers (~45s)
-- **[Tool Execution WebM](./neurolink-demo/videos/mcp-demos/mcp-tool-execution-demo.webm) | [MP4](./neurolink-demo/videos/mcp-demos/mcp-tool-execution-demo.mp4)** - Executing tools from external MCP servers (~60s)
-- **[Workflow Integration WebM](./neurolink-demo/videos/mcp-demos/mcp-workflow-integration-demo.webm) | [MP4](./neurolink-demo/videos/mcp-demos/mcp-workflow-integration-demo.mp4)** - Complete workflow using multiple MCP servers (~90s)
-
-**MCP Documentation**: All MCP visual content demonstrates real external server integration and tool execution capabilities.
-
-**Video Quality**: All CLI videos now use professional H.264 encoding with universal compatibility across platforms and documentation systems.
-
-### 💻 Live Interactive Demo
-- **Working Express.js server** with real API integration
-- **All 3 providers functional** (OpenAI, Bedrock, Vertex AI)
-- **15+ use cases** demonstrated across business, creative, and developer tools
-- **Real-time provider analytics** with performance metrics
-
-**Access**: `cd neurolink-demo && npm start` - [📁 View complete visual documentation](./neurolink-demo/)
-
-## 📚 Documentation
-
-### Quick Reference
-- **[🖥️ CLI Guide](./docs/CLI-GUIDE.md)** - Complete CLI commands, options, and examples
-- **[🏗️ Framework Integration](./docs/FRAMEWORK-INTEGRATION.md)** - SvelteKit, Next.js, Express.js, React hooks
-- **[🔧 Environment Variables](./docs/ENVIRONMENT-VARIABLES.md)** - Complete setup guide for all AI providers
-- **[⚙️ Provider Configuration](./docs/PROVIDER-CONFIGURATION.md)** - OpenAI, Bedrock, Vertex AI setup guides
-- **[📚 API Reference](./docs/API-REFERENCE.md)** - Complete TypeScript API documentation
-- **[🎬 Visual Demos](./docs/VISUAL-DEMOS.md)** - Screenshots, videos, and interactive examples
+**📖 [Complete Setup Guide](./docs/PROVIDER-CONFIGURATION.md)** - All providers with detailed instructions
 
-### Key Features
+## ✨ Key Features
 
-🔄 **Multi-Provider Support** - OpenAI, Amazon Bedrock, Google Vertex AI
-⚡ **Automatic Fallback** - Seamless provider switching on failures
-📡 **Streaming & Non-Streaming** - Real-time responses and standard generation
-🎯 **TypeScript First** - Full type safety and IntelliSense support
-🛡️ **Production Ready** - Extracted from proven production systems
-🔧 **Zero Config** - Works out of the box with environment variables
+- 🔄 **5+ AI Providers** - OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic, Azure
+- ⚡ **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 support for extensibility
+- 🤖 **AI Analysis Tools** - Built-in optimization and workflow assistance
 
-## 🖥️ CLI Tool
+## 💻 Essential Examples
 
-### Core Commands
+### CLI Commands
 
 ```bash
-# Text Generation
-npx @juspay/neurolink generate-text "Explain quantum computing"
-npx @juspay/neurolink generate-text "Write a story" --provider openai --temperature 0.9
+# Text generation with provider selection
+npx @juspay/neurolink generate-text "Explain quantum computing" --provider openai
 
-# Real-time Streaming
+# Real-time streaming
 npx @juspay/neurolink stream "Tell me a story about robots"
 
-# Batch Processing
+# 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
-
-# Provider Diagnostics
-npx @juspay/neurolink status --verbose
-npx @juspay/neurolink get-best-provider
 ```
 
-### CLI Features
-
-✨ **Professional UX** - Animated spinners, colorized output, progress tracking
-🛠️ **Developer-Friendly** - Multiple output formats, provider selection, status monitoring
-🔧 **Automation Ready** - JSON output, exit codes, scriptable for CI/CD pipelines
-
-**[📖 View complete CLI documentation](./docs/CLI-GUIDE.md)**
+### SDK Integration
 
-## 🏗️ Framework Integration
-
-### SvelteKit
 ```typescript
-import { createBestAIProvider } from '@juspay/neurolink';
-
+// 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
-```typescript
-import { createBestAIProvider } from '@juspay/neurolink';
 
+// Next.js API route
 export async function POST(request: NextRequest) {
   const { prompt } = await request.json();
   const provider = createBestAIProvider();
@@ -251,115 +103,76 @@ export async function POST(request: NextRequest) {
 }
 ```
 
-### React Hook
-```typescript
-import { useState } from 'react';
-
-export function useAI() {
-  const [loading, setLoading] = useState(false);
-
-  const generate = async (prompt: string) => {
-    setLoading(true);
-    const response = await fetch('/api/ai', {
-      method: 'POST',
-      body: JSON.stringify({ prompt })
-    });
-    const data = await response.json();
-    setLoading(false);
-    return data.text;
-  };
-
-  return { generate, loading };
-}
-```
-
-**[📖 View complete framework integration guide](./docs/FRAMEWORK-INTEGRATION.md)**
+## 🎬 See It In Action
 
-## ⚙️ Provider Configuration
+**No installation required!** Experience NeuroLink through comprehensive visual documentation:
 
-### OpenAI
+### 📱 Interactive Web Demo
 ```bash
-export OPENAI_API_KEY="sk-your-openai-key"
-```
-
-### Amazon Bedrock (⚠️ Requires Inference Profile ARN)
-```bash
-export AWS_ACCESS_KEY_ID="your-access-key"
-export AWS_SECRET_ACCESS_KEY="your-secret-key"
-export BEDROCK_MODEL="arn:aws:bedrock:us-east-2:<account_id>:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0"
-```
-
-### Google Vertex AI (Multiple Auth Methods)
-```bash
-# Method 1: Service Account File
-export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
-export GOOGLE_VERTEX_PROJECT="your-project-id"
-
-# Method 2: JSON String
-export GOOGLE_SERVICE_ACCOUNT_KEY='{"type":"service_account",...}'
-export GOOGLE_VERTEX_PROJECT="your-project-id"
-
-# Method 3: Individual Variables
-export GOOGLE_AUTH_CLIENT_EMAIL="service-account@project.iam.gserviceaccount.com"
-export GOOGLE_AUTH_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n..."
-export GOOGLE_VERTEX_PROJECT="your-project-id"
-```
-
-**[📖 View complete provider configuration guide](./docs/PROVIDER-CONFIGURATION.md)**
-
-## 📚 API Reference
-
-### Core Functions
-```typescript
-// Auto-select best provider
-const provider = createBestAIProvider();
-
-// Specific provider
-const openai = AIProviderFactory.createProvider('openai', 'gpt-4o');
-
-// With fallback
-const { primary, fallback } = createAIProviderWithFallback('bedrock', 'openai');
+cd neurolink-demo && node server.js
+# Visit http://localhost:9876 for live demo
 ```
 
-### Provider Interface
-```typescript
-interface AIProvider {
-  generateText(options: GenerateTextOptions): Promise<GenerateTextResult>;
-  streamText(options: StreamTextOptions): Promise<StreamTextResult>;
-}
-
-interface GenerateTextOptions {
-  prompt: string;
-  temperature?: number;    // 0.0 to 1.0, default: 0.7
-  maxTokens?: number;      // Default: 500
-  systemPrompt?: string;
-}
-```
+- **Real AI Integration**: All 5 providers functional with live generation
+- **Complete Use Cases**: Business, creative, and developer scenarios
+- **Performance Metrics**: Live provider analytics and response times
 
-### Supported Models
-- **OpenAI**: `gpt-4o` (default), `gpt-4o-mini`, `gpt-4-turbo`
-- **Bedrock**: `claude-3-7-sonnet` (default), `claude-3-5-sonnet`, `claude-3-haiku`
-- **Vertex AI**: `gemini-2.5-flash` (default), `claude-sonnet-4@20250514`
+### 🖥️ CLI Demonstrations
+- **[CLI Help & Commands](./docs/visual-content/cli-videos/cli-01-cli-help.mp4)** - Complete command reference
+- **[Provider Status Check](./docs/visual-content/cli-videos/cli-02-provider-status.mp4)** - Connectivity verification
+- **[Text Generation](./docs/visual-content/cli-videos/cli-03-text-generation.mp4)** - Real AI content creation
 
-**[📖 View complete API reference](./docs/API-REFERENCE.md)**
+### 🌐 Web Interface Videos
+- **[Business Use Cases](./neurolink-demo/videos/business-use-cases.mp4)** - Professional applications
+- **[Developer Tools](./neurolink-demo/videos/developer-tools.mp4)** - Code generation and APIs
+- **[Creative Tools](./neurolink-demo/videos/creative-tools.mp4)** - Content creation
 
-## 🎯 Visual Content Benefits
+**[📖 Complete Visual Documentation](./docs/VISUAL-DEMOS.md)** - All screenshots and videos
 
-- ✅ **No Installation Required** - See everything in action before installing
-- ✅ **Real AI Content** - All screenshots and videos show actual AI generation
-- ✅ **Professional Quality** - 1920x1080 resolution suitable for documentation
-- ✅ **Complete Coverage** - Every major feature visually documented
-- ✅ **Production Validation** - Demonstrates real-world usage patterns
-
-**[📖 View complete visual demonstrations](./docs/VISUAL-DEMOS.md)**
-
-## 🚀 Getting Started
+## 📚 Documentation
 
-1. **Try CLI immediately**: `npx @juspay/neurolink status`
-2. **View live demo**: `cd neurolink-demo && npm start`
-3. **Set up providers**: See [Provider Configuration Guide](./docs/PROVIDER-CONFIGURATION.md)
-4. **Integrate with your framework**: See [Framework Integration Guide](./docs/FRAMEWORK-INTEGRATION.md)
-5. **Build with the SDK**: See [API Reference](./docs/API-REFERENCE.md)
+### Getting Started
+- **[🔧 Provider Setup](./docs/PROVIDER-CONFIGURATION.md)** - Complete environment configuration
+- **[🖥️ CLI Guide](./docs/CLI-GUIDE.md)** - All commands and options
+- **[🏗️ SDK Integration](./docs/FRAMEWORK-INTEGRATION.md)** - Next.js, SvelteKit, React
+- **[⚙️ Environment Variables](./docs/ENVIRONMENT-VARIABLES.md)** - Full configuration guide
+
+### Advanced Features
+- **[🔄 MCP Foundation](./docs/MCP-FOUNDATION.md)** - Model Context Protocol architecture
+- **[🧠 AI Analysis Tools](./docs/AI-ANALYSIS-TOOLS.md)** - Usage optimization and benchmarking
+- **[🛠️ AI Workflow Tools](./docs/AI-WORKFLOW-TOOLS.md)** - Development lifecycle assistance
+- **[🎬 Visual Demos](./docs/VISUAL-DEMOS.md)** - Screenshots and videos
+
+### Reference
+- **[📚 API Reference](./docs/API-REFERENCE.md)** - Complete TypeScript API
+- **[🔗 Framework Integration](./docs/FRAMEWORK-INTEGRATION.md)** - SvelteKit, Next.js, Express.js
+
+## 🏗️ Supported Providers & Models
+
+| Provider | Models | Auth Method | Free Tier |
+|----------|--------|-------------|-----------|
+| **OpenAI** | GPT-4o, GPT-4o-mini | API Key | ❌ |
+| **Google AI Studio** | Gemini 1.5/2.0 Flash/Pro | API Key | ✅ |
+| **Amazon Bedrock** | Claude 3.5/3.7 Sonnet | AWS Credentials | ❌ |
+| **Google Vertex AI** | Gemini 2.5 Flash | Service Account | ❌ |
+| **Anthropic** | Claude 3.5 Sonnet | API Key | ❌ |
+| **Azure OpenAI** | GPT-4, GPT-3.5 | API Key + Endpoint | ❌ |
+
+**✨ 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
 
@@ -382,7 +195,7 @@ MIT © [Juspay Technologies](https://juspay.in)
 
 - [Vercel AI SDK](https://github.com/vercel/ai) - Underlying provider implementations
 - [SvelteKit](https://kit.svelte.dev) - Web framework used in this project
-- [Lighthouse](https://github.com/juspay/lighthouse) - Original source project
+- [Model Context Protocol](https://modelcontextprotocol.io) - Tool integration standard
 
 ---