Repolode
GeminiLight

GeminiLight/SocialCoach

An AI social-skills coach that lets you rehearse difficult conversations like raises, boundaries and conflicts through role-play, then gives feedback based on what you said.

Stars
272
Forks
44
Open issues
0
Last commit
8 days ago

What is it?

SocialCoach is a web app for practicing everyday social conversations, such as asking your boss for a raise, declining extra work, or asking a friend to repay a loan. You pick a scenario from a library of 58 across seven life situations, or describe your own situation, and then talk with an AI character who has its own goals and will push back, ask follow-up questions and hold its position.

After each session, the coach debriefs by quoting your own words before commenting, and separates how well you communicated from whether the conversation reached the outcome you wanted. Practice sessions are recommended based on your goals and estimated skill levels across 34 social-emotional skills, and the coaching draws on a sourced library of strategies and cases. The interface and content are available in Chinese and English, and the app is designed to run without an account.

The project is built with Next.js, React, Three.js and TypeScript, and works with Anthropic or OpenAI-compatible model providers. Users can bring their own API keys, and the repository includes Docker Compose and Vercel deployment setups.

Key features

  • 01Role-play conversations where the AI character responds from its own position and goals.
  • 02Debriefs that quote your own words and separate communication quality from the outcome.
  • 03Personalized practice recommendations based on goals and skill estimates across 34 skills.
  • 04A library of 58 scenarios across seven life situations, in Chinese and English.
  • 05Bring-your-own model keys for Anthropic or OpenAI-compatible providers, with local data export.
  • 06Optional timed responses for practicing under pressure.

Use cases

  • Rehearsing a salary negotiation or performance conversation before it happens.
  • Practicing how to set boundaries with friends, roommates or family.
  • Preparing for a tense meeting or a conflict with a coworker.
  • Building social-emotional skills for personal growth in a private, account-free setting.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/GeminiLight/SocialCoach.git
  2. 2

    Enter the app folder and install dependencies

    cd SocialCoach/app && pnpm install
  3. 3

    Copy the env template and set your model provider key in .env.local

    cp .env.example .env.local
  4. 4

    Start the dev server and open localhost:3000

    pnpm dev

Things to know

  • Requires Node.js 22+, pnpm 11, and an Anthropic or OpenAI-compatible API key to run locally.
  • Practice sessions send conversation context to your configured model provider, so model costs apply.

Topics

FAQ

What is SocialCoach?
An AI social-skills coach that lets you rehearse difficult conversations like raises, boundaries and conflicts through role-play, then gives feedback based on what you said. SocialCoach is a web app for practicing everyday social conversations, such as asking your boss for a raise, declining extra work, or asking a friend to repay a loan. You pick a scenario from a library of 58 across seven life situations, or describe your own situation, and then talk with an AI character who has its own goals and will push back, ask follow-up questions and hold its position.
Is SocialCoach free to use? What license does it have?
SocialCoach is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is SocialCoach still maintained?
Actively maintained. The last commit to SocialCoach was on Oct 12, 2026.
What can I use SocialCoach for?
Rehearsing a salary negotiation or performance conversation before it happens. Practicing how to set boundaries with friends, roommates or family. Preparing for a tense meeting or a conflict with a coworker. Building social-emotional skills for personal growth in a private, account-free setting.
How do I install SocialCoach?
Clone the repository: git clone https://github.com/GeminiLight/SocialCoach.git Enter the app folder and install dependencies: cd SocialCoach/app && pnpm install Copy the env template and set your model provider key in .env.local: cp .env.example .env.local Start the dev server and open localhost:3000: pnpm dev
Where can I get SocialCoach?
The source code and installation instructions are on GitHub: https://github.com/GeminiLight/SocialCoach

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects