A hands-on tutorial that teaches AI agent building from scratch with local LLMs via node-llama-cpp, covering function calling, memory and ReAct.
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
Clone the repository
git clone https://github.com/GeminiLight/SocialCoach.git - 2
Enter the app folder and install dependencies
cd SocialCoach/app && pnpm install - 3
Copy the env template and set your model provider key in .env.local
cp .env.example .env.local - 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
A step-by-step educational project that builds Retrieval-Augmented Generation from scratch in JavaScript using local LLMs and no cloud APIs.
A collection of 54 single-file, dependency-free Python scripts that implement modern AI algorithms from scratch so their internals are readable.
Companion code for the book Designing Multi-Agent Systems, including PicoAgents, a multi-agent framework built from scratch for teaching.
Cherry Studio is a cross-platform desktop AI client that connects to many LLM providers, local models and 300+ preset assistants.
A modular Agentic RAG tutorial and project built with LangGraph, featuring hierarchical indexing, conversation memory, and query clarification.