Skip to content
m3ruPublic

About

🌟 🌟 First-Place Winner of Google Gemini Prize at HackGT 2025! 🌟 🌟Transforming today’s technical talent into tomorrow’s executives using personalized AI-native training simulations and advanced coaching analytics.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

312 Commits

Folders and files

Repository files navigation

Ming Management Training

image

Ming, featuring realtime voice chat, live sentiment analysis, and a detailed scenario overview.

Google Gemini Cloudflare React

🏆 First-Place Winner — Best use of Google Gemini (MLH) at HackGT 2025

Ming is an AI-native, multi-agent L&D platform that transform current and aspiring engineer to managers via practicing real-world workplace scenarios (performance reviews, conflict resolution, even layoffs) through LLM-driven role-play with detailed analysis and actionable feedback.


Why Ming?

  • Bridge technical → managerial: Upskill engineers into empathetic, effective managers—faster and more affordably than hiring externally.
  • Soft-skills that scale: High-quality practice for communication, coaching, and conflict resolution—skills traditional trainings rarely teach well.
  • AI-economy ready: As automation reshapes work, Ming helps people build durable, human-centered competencies.

What it does

  • Role-played conversations with LLM NPCs across tricky scenarios (reviews, conflicts, reorganizations, exits).
  • Real-time voice & signals: Live sentiment analysis, pacing, interruptions, and conversational grounding.
  • Deep debriefs: Annotated transcripts, strengths/areas to improve, and personalized follow-ups.
  • Adaptive curriculum: New scenarios are generated from each user’s performance profile.

Interface

image

Our analysis page, with an annotated transcript, summary, and voice-integrated chat to receive further feedback.


How we built it

  • Frontend: Next.js (App Router) + React, Tailwind, shadcn/ui
  • Orchestration: CedarOS to integrate frontend with multi-agent runtime
  • Backend: Mastra connected to Google Gemini (LLM + Sentiment Analysis)
  • Infra: Deployed full-stack to Cloudflare, hosted on our own domain
  • Architecture: Multi-agent LLMs coordinate roles (manager, employee, facilitator/coach) for realistic dynamics

Quickstart

Prereqs: Node 20+ and npm

# 1) Install root deps
npm i

# 2) Install backend deps
cd src/backend
npm i

# 3) Back to project root
cd ../../

# 4) Configure the project root .env (see variables below)

# 5) Run dev servers
npm run dev

Keep environment variables in the project root .env. The frontend and backend both use this file; src/backend/.env is not needed. The backend dev and start scripts explicitly select the root file, including when run from src/backend or through npm --prefix src/backend.

Environment variables (example):

  • OPENAI_API_KEY — required for text generation and the sentiment meter (GPT-5.4 Mini), speech transcription, and speech synthesis
  • NEXT_PUBLIC_URL* — (optional) for connecting Frontend to Mastra Backend in production by providing Mastra Backend URL

All backend text agents use the shared model in src/backend/src/mastra/models.ts.

Voice conversations use OpenAI GPT-Live (gpt-live-1) over WebRTC. The root OPENAI_API_KEY must belong to a project with GPT-Live access. Run on localhost or HTTPS and allow microphone access when the chat opens. The voice connection starts automatically with the microphone muted. Hold Space (outside the text editor) or hold the microphone button to stream speech immediately; release only mutes the microphone. Sending does not wait for release. The connection stays open between presses. Use the phone button to end it. End Scenario finishes voice transcription before generating the report. The browser receives no OpenAI API key. Mastra supplies scenario facts and saves the spoken transcript; typed chat continues to use the text model.

Set NEXT_PUBLIC_URL to the Mastra backend URL in deployments. Local development defaults to http://localhost:4111. Run npm run test:voice for the voice protocol and lifecycle regression checks.


Features (highlights)

  • 🎭 Multi-agent scenarios with realistic personalities and constraints
  • 🗣️ Realtime voice (speak to the NPCs; they speak back)
  • 📈 Live sentiment & signals to nudge pacing and tone
  • 🧠 Strengths/weaknesses modeling → personalized next scenarios
  • 📝 Annotated transcripts with feedback and targeted micro-lessons
  • ⚙️ Pluggable scenarios (JSON/YAML) for custom org content

Challenges we solved

  • Cloudflare production split: We initially bundled Next.js and the Mastra server into a single Wrangler target, then split into two services and pointed the Next.js server to Mastra—stabilizing deploys and edge runtime behavior.

Inspiration

We want to help people learn and build skills that endure. Technical orgs need more managers who combine deep engineering instincts with excellent people leadership. Traditional trainings are generic and forgettable; Ming aims to be hands-on, adaptive, and effective.


Tech stack

  • UI: Next.js, React, Tailwind, shadcn/ui
  • AI/Agents: Mastra, Google Gemini (LLM + Sentiment)
  • Orchestration: CedarOS
  • Infra: Cloudflare (Workers/Pages), custom domain

Roadmap

  • 🧪 Stakeholder pilots & usability testing
  • 🕊️ Multi-party conversations (e.g., mediating conflict between two coworkers)
  • ⚡ Ultra-low-latency agent interactions
  • 🥽 Immersive AR/VR practice environments
  • 📱 Seamless mobile support
  • 🔎 Culture-aware scaling: learn patterns within a company to tailor coaching

Acknowledgements

  • Major League Hacking (MLH) — Best use of Google Gemini Prize (HackGT 2025) 🏅
  • Thanks to mentors, judges, and early testers for feedback!

About

🌟 🌟 First-Place Winner of Google Gemini Prize at HackGT 2025! 🌟 🌟Transforming today’s technical talent into tomorrow’s executives using personalized AI-native training simulations and advanced coaching analytics.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages