bluefly/llm_platform

Enterprise AI coordination platform with comprehensive AI provider support, vector databases, and intelligent workflows built on Drupal 11 standards.

Installs: 68

Dependents: 0

Suggesters: 0

Security: 0

Type:drupal-recipe

0.1.0 2025-08-05 17:52 UTC

This package is auto-updated.

Last update: 2025-08-27 13:42:26 UTC


README

Complete AI development platform with gateway architecture, vector search, MCP registry, and comprehensive analytics dashboard.

Purpose

This recipe installs and configures a full AI development ecosystem on Drupal, providing:

  • LLM Gateway: Unified AI provider access and management
  • Vector Search: Semantic search and embeddings
  • MCP Registry: Model Context Protocol tool integration
  • AI Agents: CrewAI, HuggingFace, and orchestration systems
  • Government Compliance: FedRAMP, NIST 800-53, FISMA support
  • Analytics Dashboard: Comprehensive monitoring and metrics

Prerequisites

  • Drupal: 10.5+ or 11.0+
  • PHP: 8.1+
  • Database: MySQL 8.0+ or PostgreSQL 13+
  • Memory: 2GB+ recommended
  • Storage: 10GB+ recommended

Required Contrib Modules

The recipe installs these dependencies automatically:

  • ai (2.0+): Core AI functionality
  • key (1.17+): Secure credential management
  • eck (2.0+): Entity Construction Kit
  • search_api: Search and indexing framework
  • token: Token replacement system
  • pathauto: URL alias automation

Installation

Apply Recipe

# Via Drupal CLI
php core/scripts/drupal recipe /path/to/llm_platform -v

# Via Drush 13+
drush recipe /path/to/llm_platform

Post-Installation Configuration

  1. Configure AI Providers

    • Navigate to /admin/config/ai/providers
    • Add your API keys via Key module
    • Configure LLM Gateway endpoints
  2. Set up Vector Search

    • Go to /admin/config/search/api
    • Configure vector search server
    • Index your content for semantic search
  3. Register MCP Tools

    • Access /admin/config/mcp/registry
    • Register external tools and services
    • Configure tool permissions
  4. Review Compliance Settings

    • Visit /admin/config/gov/compliance
    • Enable required frameworks (FedRAMP, NIST, etc.)
    • Configure audit and monitoring settings

Environment Configuration

Required Environment Variables

# LLM Gateway
LLM_GATEWAY_URL=https://your-gateway.example.com
LLM_GATEWAY_API_KEY=your_secure_api_key

# Vector Database (Qdrant)
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=your_qdrant_key

# MCP Registry
MCP_REGISTRY_ENDPOINT=http://localhost:8080
MCP_REGISTRY_TOKEN=your_mcp_token

Secure Key Management

Use Drupal's Key module for sensitive configuration:

# Create keys via Drush
drush key:create llm_gateway_key --type=authentication --provider=config --input-type=text

# Or via admin interface at /admin/config/system/keys

User Roles

The recipe creates these specialized roles:

AI Developer (ai_developer)

  • Access LLM Gateway and analytics
  • Manage AI conversations and providers
  • Configure MCP registry
  • Use REST/JSON APIs

AI Manager (ai_manager)

  • All AI Developer permissions
  • Government compliance management
  • Administrative access
  • Training job management

Content Types

Default content includes:

  • Welcome Page: Platform introduction and feature overview
  • Getting Started Guide: Step-by-step configuration instructions
  • API Documentation: Developer resources and examples

Performance Optimization

  • Caching: 1-hour page cache with CSS/JS aggregation
  • Database: Optimized for AI workloads with proper indexing
  • Memory: Configured for large language model processing

Security Features

  • User Registration: Admin-only by default
  • API Access: Controlled via role-based permissions
  • Email Verification: Required for new accounts
  • Audit Logging: Comprehensive activity tracking

Rollback Instructions

To remove this recipe's changes:

  1. Uninstall Modules (reverse dependency order):

    drush pm:uninstall recipe_onboarding gov_compliance ai_provider_langchain ai_provider_apple ai_agentic_workflows ai_agent_huggingface ai_agent_crewai ai_agent_orchestra mcp_registry llm api_normalizer alternative_services
    
  2. Remove Custom Roles:

    drush role:delete ai_developer
    drush role:delete ai_manager
    
  3. Delete Content:

    # Delete nodes created by recipe
    drush entity:delete node --bundle=page --filter="title=Welcome to LLM Platform"
    
  4. Reset Configuration:

    # Reset site settings
    drush config:set system.site name "Drupal" slogan ""
    drush config:set system.theme default claro admin claro
    

Troubleshooting

Module Dependencies

If installation fails with dependency errors:

# Install missing modules manually
composer require drupal/ai drupal/key drupal/eck
drush pm:enable ai key eck

# Then retry recipe
drush recipe /path/to/llm_platform

Memory Issues

For large installations:

# Increase PHP memory limit
php -d memory_limit=2G core/scripts/drupal recipe /path/to/llm_platform

Permission Errors

If role creation fails:

# Check existing roles
drush role:list

# Manually create missing roles
drush role:create ai_developer "AI Developer"
drush role:create ai_manager "AI Manager"

Support

  • Documentation: See /docs directory for technical details
  • Issues: Report problems via project issue queue
  • API Reference: Available at /admin/help/api after installation

Version History

  • 1.0.0: Initial production release
  • 1.1.0: Added government compliance framework
  • 1.2.0: Enhanced MCP registry integration
  • Current: Vector search optimization and security hardening

License

This recipe follows the same license as Drupal core (GPL-2.0+).