Skip to content

free-models-update.md

Latest commit

 

History

History
254 lines (175 loc) · 8.11 KB

free-models-update.md

File metadata and controls

254 lines (175 loc) · 8.11 KB

Free Models Update - Enhanced Configuration and Preview Models

Date: June 18, 2025 Status: ✅ COMPLETED & UPDATED

Overview

Enhanced the VT platform's free tier by updating GEMINI_3_FLASH_LITE configuration, making all Preview models free, and improving subscription benefit descriptions.

Latest Changes (June 18, 2025)

1. Updated GEMINI_3_FLASH_LITE Token Configuration

Token Limits Updated (packages/ai/models.ts)

  • Input Token Limit: 1,000,000 tokens (contextWindow)
  • Output Token Limit: 64,000 tokens (maxTokens)
  • Updated from previous 1,048,576 for both values

2. Made All Preview Models Free

GEMINI_3_PRO Corrected to Premium (packages/ai/models.ts)

  • GEMINI_3_PRO (gemini-2.5-pro-preview-05-06) - corrected to isFree: false (is NOT a free model)
  • Removed Gift Icon in chat-actions.tsx for accurate pricing representation

All Preview Models Now Free (except GEMINI_3_PRO)

  • GEMINI_3_FLASH_LITE ✅ (1M input/64K output)
  • GEMINI_3_FLASH_PREVIEW ✅
  • GEMINI_3_PRO ❌ (NOT free - premium model)
  • GEMINI_3_PRO_PREVIEW ✅

Chat Actions UI (packages/common/components/chat-input/chat-actions.tsx)

  • Added missing GEMINI_3_FLASH_LITE to the Google provider section
  • Added Gift icons to all free Gemini models:
    • GEMINI_3_FLASH_LITE ✅ (newly added)
    • GEMINI_3_FLASH_PREVIEW ✅
    • GEMINI_3_PRO_PREVIEW ✅

Workflow Utils (packages/ai/workflow/utils.ts)

  • Added GEMINI_3_FLASH_LITE to the API key mapping for model selection
  • Added GEMINI_3_FLASH to the API key mapping (was missing)
  • Ensures proper fallback mechanism works for all Gemini models

Models Configuration (packages/ai/models.ts)

  • Added web search support for GEMINI_3_FLASH_LITE and GEMINI_3_FLASH
  • Updated supportsNativeWebSearch function to include the new models
  • Confirmed isFree: true flag is properly set for free models

2. Updated Subscription Benefits

Pricing Configuration (apps/web/lib/config/pricing.ts)

  • Enhanced "Access to Free Models" benefit to include all available free models:
    • Gemini 3 Pro Preview
    • Gemini 3 Flash
    • Gemini 3 Flash Lite Preview
    • DeepSeek V3
    • DeepSeek R1
    • Qwen3 14B
  • Maintained existing benefits:
    • Mathematical Calculator Tools (with detailed description)
    • Access to Base Features
    • Perfect for Getting Started with VT

3. Enhanced Subscription Benefits

Updated Free Tier Benefits (apps/web/lib/config/pricing.ts)

  • Updated "Access to Free Models" description to include all 4 free Gemini models
  • Enhanced model list now includes:
    • Gemini 3 Flash
    • Gemini 3 Flash Lite (1M input/64K output tokens)
    • Gemini 3 Pro
    • Gemini 3 Flash Preview
    • DeepSeek V3, DeepSeek R1, Qwen3 14B (OpenRouter models)

Enhanced Plus Tier Benefits (apps/web/lib/config/pricing.ts)

  • Added "All Benefits from Base Plan" as first benefit
  • Clear hierarchy showing Plus builds on Free tier
  • Maintained existing Plus features:
    • Grounding Web Search
    • Dark Mode
    • Priority Support
    • Unlimited Usage
    • Advanced AI Capabilities

API Key Configuration Updates

  • Added GEMINI_3_FLASH_LITE to api-key-prompt-modal.tsx
  • Ensures proper API key prompting for all Gemini models
  • Consistent user experience across all model selections

3. Updated Documentation

README.md

  • Added "Free Models Access" section highlighting available free models
  • Organized by provider: Google Gemini and OpenRouter models
  • Included mathematical tools in the free tier description

Created Documentation (docs/free-models-update.md)

  • Comprehensive documentation of all changes made
  • Clear benefit descriptions for users and developers
  • Verification steps for testing the implementation

Free Models Available

Google Gemini (Free Tier)

  • Gemini 3 Flash - Fast, efficient model for general tasks
  • Gemini 3 Flash Lite Preview - Preview access to latest features
  • Gemini 3 Pro Preview - Preview access to Pro-level capabilities (Note: Gemini 3 Pro is premium only)

OpenRouter Models (Free Tier)

  • DeepSeek V3 0324 - Advanced reasoning model
  • DeepSeek R1 - Research-focused model
  • DeepSeek R1 0528 - Updated research model
  • Qwen3 14B - Multilingual capabilities

Mathematical Tools (Free Tier)

  • Trigonometric functions (sin, cos, tan, etc.)
  • Logarithmic and exponential operations
  • Basic arithmetic calculations
  • Essential mathematical operations

User Interface Improvements

Visual Indicators

  • Gift icons (🎁) now appear for all free models in the dropdown
  • Provider grouping maintained for clear organization
  • Consistent labeling across all free models

Model Selection

  • Proper fallback mechanism ensures users can access available models
  • API key validation prevents runtime errors
  • Clear error messages guide users to proper configuration

Benefits for Users

VT_BASE (Free) Tier

  1. Expanded Model Access: Now includes 4 free Gemini models + 4 OpenRouter models
  2. Mathematical Tools: Full calculator functionality included
  3. Base Features: Core functionality for getting started
  4. Perfect Introduction: Comprehensive free tier for exploring VT capabilities

Enhanced User Experience

  • More model choices in the free tier
  • Better visual indicators for free models
  • Improved documentation for understanding available features
  • Seamless upgrade path to VT_PLUS for premium features

Technical Benefits

Code Quality

  • Consistent model handling across all components
  • Proper TypeScript types for all new models
  • Comprehensive error handling and validation
  • Maintained backward compatibility

Maintainability

  • Centralized configuration for easy updates
  • Clear separation between free and premium features
  • Documented code patterns for future model additions
  • Standardized benefit descriptions

Verification Steps

1. UI Testing

# Start development server
bun dev

# Navigate to chat interface
# Verify GEMINI_3_FLASH_LITE appears in Google section
# Verify all free models show gift icons

2. Model Functionality

# Test model selection and switching
# Verify web search works with Gemini models
# Test mathematical calculator tools

3. Subscription Display

# Check pricing page shows updated benefits
# Verify free tier accurately describes available models
# Test benefit descriptions are clear and accurate

Files Modified

Core Configuration

  • packages/ai/models.ts - Web search support for new models
  • packages/ai/workflow/utils.ts - API key mapping for model selection
  • packages/shared/config/chat-mode.ts - Already properly configured

User Interface

  • packages/common/components/chat-input/chat-actions.tsx - Added GEMINI_3_FLASH_LITE and gift icons
  • apps/web/lib/config/pricing.ts - Updated free tier benefits

Documentation

  • README.md - Added free models section
  • docs/free-models-update.md - Comprehensive documentation

Next Steps

Optional Enhancements

  1. Model Performance Metrics: Add usage analytics for free models
  2. User Guidance: Create onboarding for free model selection
  3. Feature Discovery: Highlight mathematical tools in UI
  4. Model Recommendations: Suggest best free model for specific tasks

Monitoring

  1. Usage Patterns: Track which free models are most popular
  2. Error Rates: Monitor API key validation effectiveness
  3. User Feedback: Collect feedback on free tier experience
  4. Performance: Ensure free models maintain good response times

Conclusion

This update significantly enhances the VT free tier by:

  • Adding GEMINI_3_FLASH_LITE model support
  • Improving visual indicators for free models
  • Updating benefit descriptions to be accurate and comprehensive
  • Maintaining code quality and proper architecture
  • Providing clear documentation for future reference

Users now have access to a robust set of free AI models with clear visual indicators and comprehensive mathematical tools, making VT an excellent platform for getting started with AI capabilities.