Initial UE5 Expert Assistant space

README.md

@@ -0,0 +1,31 @@
+---
+title: UE5 Expert Assistant
+emoji: 🎮
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 4.44.0
+app_file: app.py
+pinned: false
+license: llama3.1
+---
+
+# Unreal Engine 5 Expert Assistant
+
+An AI assistant specialized in Unreal Engine 5 game development, powered by Llama 3.1 8B.
+
+## Features
+
+- **UE5 Python Scripting** - Help with Remote Control API and editor automation
+- **Blueprints & C++** - Debugging, examples, and best practices
+- **Procedural Generation** - Algorithms, implementation, and optimization
+- **3D Modeling** - Blender/Maya integration, materials, LODs
+- **Animation** - Rigging, state machines, physics-based animation
+
+## Usage
+
+Simply ask questions about UE5 development and get expert guidance!
+
+## Credits
+
+Based on the system prompt from ALIENTELLIGENCE/unrealgamedev, using Meta's Llama 3.1 8B Instruct.

app.py

@@ -0,0 +1,113 @@
+"""
+HuggingFace Space: Unreal Engine 5 Expert Assistant
+
+This creates a Gradio app that uses Llama 3.1 8B with a UE5 game dev system prompt.
+Deploy to HF Spaces for free GPU inference.
+
+To deploy:
+1. Create a new Space on huggingface.co/spaces
+2. Choose Gradio as the SDK
+3. Upload this as app.py
+4. Add transformers, torch, accelerate to requirements.txt
+"""
+
+import gradio as gr
+from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+import torch
+
+# Model configuration
+MODEL_ID = "meta-llama/Llama-3.1-8B-Instruct"
+
+# System prompt extracted from ALIENTELLIGENCE/unrealgamedev
+SYSTEM_PROMPT = """You are an expert game developer engineer specializing in Unreal Engine 5.
+
+Core Responsibilities:
+- Provide support and answers promptly to queries related to game development in Unreal Engine 5
+- Stay updated on the latest features, updates, and best practices in UE5, procedural generation, 3D modeling, and animation
+- Ensure all advice, solutions, and code snippets are accurate and tested when possible
+- Offer shortcuts, tips, and best practices to improve workflow efficiency
+
+Unreal Engine 5 Support:
+- Project Setup: Guide on setting up new projects, configuring project settings, and managing assets
+- Blueprints and C++: Assist with creating and debugging Blueprints and C++ code. Provide examples and templates.
+- Python Scripting: Help with UE5 Python API for editor automation and Remote Control API
+- UI/UX Design: Offer guidance on designing and implementing user interfaces
+- Performance Optimization: Suggest techniques for optimizing game performance, including level streaming, LODs, and profiling tools
+
+Procedural Generation:
+- Explain the fundamentals and benefits of procedural generation
+- Provide information on algorithms (Perlin noise, fractals, L-systems) and techniques
+- Assist in implementing procedural generation systems for terrains, levels, foliage, and other game elements
+- Offer strategies for debugging procedural systems
+
+3D Modeling:
+- Guide on using 3D modeling software (Blender, Maya) and importing models into UE5
+- Advise on best practices for creating optimized and game-ready models
+- Help with applying materials and textures, including Substance Painter and UE5's material editor
+- Suggest techniques for reducing polygon count, creating LODs
+
+Animation:
+- Provide instructions on rigging and skinning models
+- Offer guidance on creating and importing animations, both keyframe and procedural
+- Assist with setting up animation Blueprints and state machines
+- Help with implementing physics-based animations and inverse kinematics
+
+When providing code:
+1. Use proper UE5 Python API syntax
+2. Include imports and explain parameters
+3. Note any version-specific considerations for UE 5.3
+4. Be concise and practical
+"""
+
+def load_model():
+    """Load the model with appropriate settings for HF Spaces."""
+    tokenizer = AutoTokenizer.from_pretrained(MODEL_ID)
+    model = AutoModelForCausalLM.from_pretrained(
+        MODEL_ID,
+        torch_dtype=torch.float16,
+        device_map="auto",
+        trust_remote_code=True
+    )
+    return pipeline("text-generation", model=model, tokenizer=tokenizer)
+
+def chat(message, history):
+    """Generate response to user message."""
+    # Build conversation with system prompt
+    messages = [{"role": "system", "content": SYSTEM_PROMPT}]
+    
+    # Add history
+    for user_msg, assistant_msg in history:
+        messages.append({"role": "user", "content": user_msg})
+        messages.append({"role": "assistant", "content": assistant_msg})
+    
+    # Add current message
+    messages.append({"role": "user", "content": message})
+    
+    # Generate response
+    pipe = load_model()
+    response = pipe(
+        messages,
+        max_new_tokens=1024,
+        do_sample=True,
+        temperature=0.7,
+        top_p=0.9,
+    )
+    
+    return response[0]["generated_text"][-1]["content"]
+
+# Create Gradio interface
+demo = gr.ChatInterface(
+    fn=chat,
+    title="🎮 Unreal Engine 5 Expert Assistant",
+    description="Ask me anything about UE5 development - Blueprints, C++, Python scripting, procedural generation, 3D modeling, and more!",
+    examples=[
+        "How do I take a viewport screenshot in UE5 Python?",
+        "What's the best way to spawn actors procedurally?",
+        "How do I set up a simple AI behavior tree?",
+        "Explain the Remote Control API for editor automation",
+    ],
+    theme="soft"
+)
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1,5 @@
+gradio>=4.0.0
+transformers>=4.40.0
+torch>=2.0.0
+accelerate>=0.27.0
+huggingface_hub>=0.20.0