bluefly/llm_platform

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

This package's canonical repository appears to be gone and the package has been frozen as a result. Email us for help if needed.

Installs: 68

Dependents: 0

Suggesters: 0

Security: 0

Type:drupal-recipe

pkg:composer/bluefly/llm_platform

0.1.0 2025-08-05 17:52 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+).