Credentials. The .env.production file holds shared model credentials, so restrict server access and set a provider spending cap as the README advises.
Who it is forAn ops-minded team lead or coach who wants a private Social Coach instance on a domain they control for a small group.
The problemA shared group needs a hosted practice tool on its own domain rather than the public demo.
The outcomeThe app is reachable over HTTPS at your domain and responds to a practice request.
What you need first
- A web browser for the hosted site at socialcoach.aurax.live
- For a local run: Node.js 22+, pnpm 11, and Anthropic or OpenAI compatible model credentials
- For self-hosting: a server with Docker, a domain name pointed at it, and ports 80 and 443 open
Steps
- From the repository root, run
cd appand thencp .env.production.example .env.production. - Edit .env.production with your model credentials and rate limit settings.
- Replace example.com in the Caddyfile with your domain, point that domain's DNS to the server, and make sure ports 80 and 443 are open.
- Run
docker compose up -d --buildfrom the app folder. - Open your domain in a browser and complete one practice dialogue to confirm the deployment.
Prompt for your agent
In the SocialCoach repository, prepare a Docker Compose deployment in the app folder using <domain> and the provider settings in .env.production. Confirm that the Caddyfile uses the domain, that docker compose up -d --build succeeds, and that the site responds over HTTPS. Report the steps that need a human, such as DNS and secrets.
Caveat. The README says the shared budget service only reserves anonymous tokens and does not guarantee prices, so set a hard spending limit with your model provider before opening the site to others.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer