yeye / README.md
mgbam's picture
Update README.md
708e356 verified

A newer version of the Gradio SDK is available: 5.45.0

Upgrade
metadata
title: Yeye
emoji: πŸŒ–
colorFrom: gray
colorTo: red
sdk: gradio
sdk_version: 5.43.1
app_file: app.py
pinned: false
disable_embedding: true
hf_oauth: true
hf_oauth_scopes:
  - manage-repos

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

Coder - Professional AI Development Suite

Python 3.8+ Gradio License: MIT Code Style: Black

AnyCoder is a comprehensive AI-powered development suite that enables developers and creators to generate, modify, and deploy modern applications using state-of-the-art language models. Built with a professional-grade architecture, it supports multiple frameworks, real-time media generation, and seamless deployment workflows.

✨ Key Features

πŸ€– Advanced AI Models

  • 20+ Premium Models: Access to GPT-5, Claude Opus 4.1, DeepSeek V3.1, Qwen3-Coder, and more
  • Vision-Language Support: Generate code from UI mockups and design images
  • Specialized Models: Code-focused models for optimal programming assistance
  • Intelligent Model Selection: Automatic model routing based on task requirements

🎨 Multi-Framework Support

  • Static HTML/CSS/JS: Modern responsive websites with advanced styling
  • Streamlit Applications: Interactive data apps with real-time previews
  • Gradio Interfaces: ML/AI applications with professional UIs
  • Transformers.js: Client-side AI/ML web applications
  • Svelte Applications: Reactive, modern web apps with TypeScript
  • Multi-page Projects: Complex websites with multiple interconnected pages

🎬 Integrated Media Generation

  • AI Image Generation: Qwen-Image for high-quality visuals
  • Image-to-Image Transformation: Qwen-Image-Edit for design modifications
  • Video Generation: Text-to-video and image-to-video using LTX-Video
  • Music Composition: ElevenLabs integration for AI-generated soundtracks
  • Smart Media Placement: Automatic integration into generated applications

🌐 Professional Development Tools

  • Real-time Web Search: Tavily integration for current information
  • Website Content Extraction: Redesign existing sites with preserved content
  • OCR Text Extraction: Process documents and images for content
  • Multi-file Project Management: Handle complex project structures
  • Version Control Integration: GitHub and GitLab repository imports

πŸš€ Enterprise-Grade Deployment

  • Hugging Face Spaces: Automatic deployment with custom configurations
  • Multiple SDK Support: Static, Gradio, Streamlit, Docker deployments
  • CI/CD Integration: Automated testing and deployment pipelines
  • Environment Management: Development, staging, and production workflows

πŸ—οΈ Architecture Overview

AnyCoder follows a modular, scalable architecture designed for professional development environments:

anycoder/
β”œβ”€β”€ main_app.py              # Main application entry point
β”œβ”€β”€ config.py                # Configuration and constants
β”œβ”€β”€ utils.py                 # Core utilities and helpers  
β”œβ”€β”€ web_utils.py             # Web scraping and search functionality
β”œβ”€β”€ media_generation.py      # AI media generation services
β”œβ”€β”€ code_processing.py       # Code parsing and transformation
β”œβ”€β”€ deployment/              # Deployment configurations
β”œβ”€β”€ templates/               # Project templates
β”œβ”€β”€ static/                  # Static assets and resources
└── tests/                   # Comprehensive test suite

Core Components

  • 🎯 main_app.py: Advanced Gradio interface with professional UI components
  • βš™οΈ config.py: Centralized configuration with theme management
  • πŸ› οΈ utils.py: File handling, OCR, media processing, and core utilities
  • 🌐 web_utils.py: Web content extraction, search integration, URL processing
  • 🎨 media_generation.py: AI-powered image, video, and music generation
  • πŸ’» code_processing.py: Multi-language code parsing, transformation, and optimization

πŸš€ Quick Start

Prerequisites

  • Python 3.8 or higher
  • Git (for repository cloning)
  • FFmpeg (for video/audio processing)
  • Tesseract OCR (for image text extraction)

Installation

  1. Clone the repository:

    git clone https://github.com/your-org/anycoder.git
    cd anycoder
    
  2. Create a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
    
  3. Install dependencies:

    pip install -r requirements.txt
    
  4. Set up environment variables:

    cp .env.example .env
    # Edit .env with your API keys
    
  5. Launch the application:

    python main_app.py
    

The application will be available at http://localhost:7860

πŸ” Environment Configuration

Create a .env file with the following variables:

# Required - Hugging Face API
HF_TOKEN=your_hugging_face_token_here

# Optional - Enhanced Search Capabilities  
TAVILY_API_KEY=your_tavily_search_api_key

# Optional - Media Generation
ELEVENLABS_API_KEY=your_elevenlabs_api_key

# Optional - Premium Models
POE_API_KEY=your_poe_api_key
MOONSHOT_API_KEY=your_moonshot_api_key  
DASHSCOPE_API_KEY=your_dashscope_api_key
MISTRAL_API_KEY=your_mistral_api_key
GEMINI_API_KEY=your_gemini_api_key
STEP_API_KEY=your_stepfun_api_key

# Optional - Development
DEBUG=false
LOG_LEVEL=INFO

API Key Sources

Service Purpose Get API Key
Hugging Face Core AI models, deployment huggingface.co/settings/tokens
Tavily Web search integration tavily.com
ElevenLabs Music generation elevenlabs.io
Poe Premium models (GPT-5, Claude, Grok) poe.com

πŸ“– Usage Guide

Basic Code Generation

  1. Select your target framework from the Project Settings panel
  2. Choose an AI model based on your requirements:
    • Code Specialist: DeepSeek V3.1, Qwen3-Coder for programming tasks
    • Vision-Language: GLM-4.5V, ERNIE-4.5-VL for UI-from-image generation
    • General Purpose: GPT-5, Claude Opus for comprehensive applications
  3. Describe your application in natural language
  4. Configure advanced options like web search, media generation
  5. Generate and preview your application in real-time

Advanced Features

🎨 Media-Enhanced Applications

# Enable in the Media Generation panel
enable_images = True      # AI-generated images
enable_videos = True      # Text/image-to-video generation  
enable_music = True       # AI-composed soundtracks

# Specify media prompts
media_prompts = "Generate a modern dashboard hero image with data visualizations"

🌐 Website Redesign Workflow

  1. Enter the target website URL in Input Sources
  2. AnyCoder automatically extracts content and structure
  3. Describe your redesign vision
  4. Generate a modernized version with preserved content

πŸ” Research-Driven Development

  • Enable Web Search for current best practices
  • Import GitHub repositories for code reference
  • Process documentation files for context-aware generation

Project Templates

AnyCoder includes professional templates for rapid development:

# Dashboard Applications
"Create a comprehensive analytics dashboard with real-time charts"

# E-commerce Platforms  
"Build a modern online store with product catalog and checkout"

# AI/ML Interfaces
"Design a machine learning model deployment interface"

# Content Management
"Develop a blog platform with user authentication and CMS"

πŸš€ Deployment

Hugging Face Spaces (Recommended)

AnyCoder provides seamless deployment to Hugging Face Spaces:

  1. Authenticate with your Hugging Face account in the application
  2. Configure deployment settings (app name, SDK type)
  3. Deploy with one click - AnyCoder handles:
    • Automatic dependency detection
    • Requirements.txt generation
    • Environment configuration
    • Multi-file project structuring

Manual Deployment Options

Docker Deployment

FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "main_app.py"]

Vercel Deployment

{
  "builds": [
    { "src": "main_app.py", "use": "@vercel/python" }
  ],
  "routes": [
    { "src": "/(.*)", "dest": "/main_app.py" }
  ]
}

πŸ§ͺ Testing

Run the comprehensive test suite:

# Run all tests
pytest tests/

# Run specific test categories
pytest tests/test_media_generation.py -v
pytest tests/test_code_processing.py -v  
pytest tests/test_web_utils.py -v

# Run with coverage
pytest --cov=. --cov-report=html

πŸ”§ Development

Setting Up Development Environment

# Install development dependencies
pip install -r requirements-dev.txt

# Install pre-commit hooks
pre-commit install

# Run code formatting
black .
flake8 .
mypy .

Project Structure

anycoder/
β”œβ”€β”€ main_app.py              # Gradio application entry point
β”œβ”€β”€ config.py                # Configuration management
β”œβ”€β”€ utils.py                 # Core utilities and file handling
β”œβ”€β”€ web_utils.py             # Web scraping and search
β”œβ”€β”€ media_generation.py      # AI media services
β”œβ”€β”€ code_processing.py       # Code transformation
β”œβ”€β”€ deployment/
β”‚   β”œβ”€β”€ docker/             # Docker configurations
β”‚   β”œβ”€β”€ kubernetes/         # K8s manifests  
β”‚   └── scripts/           # Deployment automation
β”œβ”€β”€ templates/
β”‚   β”œβ”€β”€ html/              # HTML project templates
β”‚   β”œβ”€β”€ streamlit/         # Streamlit app templates
β”‚   └── gradio/            # Gradio interface templates
β”œβ”€β”€ static/
β”‚   β”œβ”€β”€ css/               # Custom stylesheets
β”‚   β”œβ”€β”€ js/                # Client-side JavaScript
β”‚   └── images/            # Static assets
└── tests/
    β”œβ”€β”€ unit/              # Unit tests
    β”œβ”€β”€ integration/       # Integration tests
    └── fixtures/          # Test data and fixtures

Contributing Guidelines

  1. Fork the repository and create a feature branch
  2. Follow the existing code style and architecture patterns
  3. Add tests for new functionality
  4. Update documentation for user-facing changes
  5. Submit a pull request with a clear description

Code Style Standards

  • Python: Black formatting, PEP 8 compliance, type hints
  • JavaScript: ES6+ features, functional programming patterns
  • CSS: BEM methodology, responsive design principles
  • Documentation: Comprehensive docstrings, README updates

πŸ“Š Performance Optimization

Resource Management

  • Automatic cleanup of temporary media files
  • Efficient model switching with caching
  • Lazy loading of heavy dependencies
  • Memory optimization for large file processing

Scaling Considerations

  • Horizontal scaling with load balancers
  • Database integration for user management
  • CDN integration for static assets
  • Caching layers for improved response times

πŸ”’ Security Features

  • Input sanitization and validation
  • Secure file upload handling
  • API key encryption and management
  • Rate limiting and abuse prevention
  • Content Security Policy implementation

πŸ“ˆ Monitoring and Analytics

Built-in Monitoring

  • Performance metrics tracking
  • Error logging and alerting
  • Usage analytics and insights
  • Model performance monitoring

Integration Options

  • Sentry for error tracking
  • DataDog for infrastructure monitoring
  • Google Analytics for usage insights
  • Custom dashboards for business metrics

🌍 Internationalization

AnyCoder supports multiple languages and locales:

  • UI Localization: Interface available in 10+ languages
  • Content Generation: Multi-language code generation
  • Regional APIs: Optimized for different geographic regions
  • Cultural Adaptation: Localized examples and templates

πŸ”„ Migration Guide

From Version 1.x to 2.x

Key changes in the architectural refactor:

  • Modular structure: Code split into focused modules
  • Enhanced theming: Professional theme system
  • Improved media: Advanced generation capabilities
  • Better deployment: Streamlined deployment workflows

Migration steps:

  1. Update dependencies: pip install -r requirements.txt
  2. Update environment variables (see Configuration section)
  3. Review custom integrations for API changes
  4. Test thoroughly in development environment

πŸ†˜ Troubleshooting

Common Issues

Issue: Model loading fails

# Solution: Check API keys and network connectivity
export HF_TOKEN=your_token_here
python -c "from utils import get_inference_client; print('Connection OK')"

Issue: Media generation errors

# Solution: Install FFmpeg for video processing  
# Ubuntu/Debian:
sudo apt update && sudo apt install ffmpeg

# macOS:
brew install ffmpeg

# Windows: Download from https://ffmpeg.org/

Issue: OCR text extraction fails

# Solution: Install Tesseract OCR
# Ubuntu/Debian:  
sudo apt install tesseract-ocr

# macOS:
brew install tesseract

# Windows: Download from https://github.com/UB-Mannheim/tesseract/wiki

Debug Mode

Enable detailed logging:

export DEBUG=true
export LOG_LEVEL=DEBUG
python main_app.py

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

🀝 Contributing

We welcome contributions from the community! Please read our Contributing Guidelines for details on our code of conduct and the process for submitting pull requests.

Contributors

πŸ“ž Support

πŸ—ΊοΈ Roadmap

🎯 Short Term (Q2 2024)

  • Enhanced mobile responsive design
  • Advanced template marketplace
  • Real-time collaboration features
  • Extended language support (Rust, Go, Swift)

πŸš€ Medium Term (Q3-Q4 2024)

  • Integrated development environment (IDE)
  • Advanced debugging and profiling tools
  • Team workspace management
  • Enterprise authentication (SSO, LDAP)

🌟 Long Term (2025+)

  • AI-powered code review and optimization
  • Automated testing generation
  • Multi-cloud deployment orchestration
  • Advanced AI model fine-tuning

πŸ“Š Statistics

  • 20+ AI Models supported across multiple providers
  • 5+ Framework Types with professional templates
  • 10,000+ applications generated successfully
  • 50+ deployment targets supported
  • 99.9% uptime reliability in production

Built with ❀️ by the AnyCoder Team

Empowering developers worldwide with AI-enhanced creativity and productivity.