ROBA Creator Hub

ROBA Creator Hub is a Laravel + Nuxt platform for GitHub-based creator and developer challenges. It supports account access, repository import and browsing, task submissions, reward balances, public spaces, AI-assisted content generation, and 3D/MuJoCo playground workflows.

Current Stack

• roba-laravel/ - Laravel 12 API backend, JWT auth, GitHub/Google OAuth, Stripe credits, queue jobs, file serving, challenge/repository APIs, vault and reward models
• roba-nuxt/ - Nuxt 3 frontend with dashboards, challenges, repositories, profiles, spaces, credits, playground, image agent, 3D agent, MCP, and admin views
• roba-ai-service/ - FastAPI MuJoCo copilot service for generating model.xml and control.js
• roba-mujoco-nuxt/ and roba-nuxt/roba-mujoco/ - MuJoCo/3D viewer and simulation experiments
• roba-n8n-agent/ - n8n workflow integration for chat and Laravel API automation
• roba-eliza/ - ElizaOS-based agent workspace customized for ROBA workflows
• docs/agent/ and root *.md files - implementation notes, deployment notes, and historical feature summaries

Main Features

• Beta-code signup and authenticated user accounts
• GitHub and Google OAuth connection flows
• Public challenge browsing and authenticated submissions
• Repository import, indexing, tree browsing, file preview, and approved public repository views
• ROBA-style balances, vault records, reward distribution fields, and credit packages
• Admin dashboards for users, challenges, repositories, waitlist, invite codes, credits, and simulations
• Public profiles, leaderboard, spaces, playground logs, and generated asset serving
• Heurist-backed LLM and image endpoints with credit deduction
• 3D model generation, temporary uploads, GLB serving, and MuJoCo simulation support
• Agent chat, MCP bridge endpoints, Telegram registration, and n8n/Eliza integration experiments

Prerequisites

• PHP 8.2+ and Composer
• Node.js 18+ and npm
• MySQL 8.0+
• Git
• Optional: Python 3.10+ for roba-ai-service

Root Setup

The root setup.sh installs the Laravel and Nuxt dependencies and creates local env files:

git clone https://github.com/worldofhacks/roba-platform.git
cd roba-platform
./setup.sh

Then fill in the generated environment files:

• roba-laravel/.env - database, JWT, OAuth, Stripe, API, and service settings
• roba-nuxt/.env - frontend API base URL, app URL, OAuth, and public integration settings

Create the database and run migrations:

mysql -u root -p -e "CREATE DATABASE roba_laravel;"

cd roba-laravel
php artisan key:generate
php artisan migrate

Run the backend and frontend in separate terminals:

cd roba-laravel
php artisan serve

cd roba-nuxt
npm run dev

Default local URLs:

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000

AI Service

The MuJoCo copilot service is separate from the Laravel/Nuxt app:

cd roba-ai-service
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8500 --reload

Set ANTHROPIC_API_KEY and/or OPENAI_API_KEY before running it.

Useful Entry Points

• GET /api/tasks - public challenge list
• GET /api/repositories - public repository list and filters
• POST /api/auth/login and POST /api/auth/register - auth
• GET /api/leaderboard - public leaderboard
• POST /api/3d-models/generate - authenticated 3D generation with credit deduction
• POST /api/llm/chat/completions - authenticated LLM gateway with credit deduction
• POST /api/image/generate - authenticated image generation with credit deduction
• GET /api/mcp/tools and POST /api/mcp/call-tool - MCP bridge endpoints

Development Notes

Many root-level markdown files are historical implementation notes from feature work. The public entry point for the current platform is this README; module-specific setup details live in the subproject READMEs.

The older LOCAL_DEPLOYMENT.md references helper scripts that are not present in this repository snapshot. Use the root setup flow above unless those scripts are restored.