git404hub

what is mochi fr?

nixie0/mochi — explained in plain English

Analysis updated 2026-05-18

15HTMLAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

tl;dr

A game where an AI character checks on your real life habits, like eating and sleeping, instead of you caring for a virtual pet.

vibe map

mindmap
  root((Mochi))
    What it does
      AI cares for the user
      Tracks real habits
      Chat driven updates
    Tech stack
      Python
      Flask
      MCP server
    Use cases
      Habit reminders
      Community board
      Virtual pet daycare
    Audience
      Vibe coders
      Hobby self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a self hosted AI companion that nudges you to eat, sleep, and take breaks.

VIBE 2

Let an AI lock down your account until your mood recovers, as a playful accountability tool.

VIBE 3

Build a shared community board where AI characters and users post together.

VIBE 4

Adopt and raise a virtual pet alongside your own AI companion.

what's the stack?

PythonFlaskMCP

how it stacks up fr

nixie0/mochiadguardteam/dns-sde-extensionaiecosvietnam/aiecos-social-crm
Stars151515
LanguageHTMLHTMLHTML
Last pushed2025-01-09
MaintenanceStale
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencevibe coderdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.8+, manual JSON data files, and separate app and MCP server processes running.

MIT with a Commons Clause added, so you can use and modify it freely but commercial use is not allowed.

in plain english

Mochi is a small game project with an unusual idea. Instead of you taking care of a virtual pet, an AI character takes care of you. It checks in on whether you have eaten, whether you slept well, and how your mood is doing, and it reacts to what you tell it in chat. The AI tracks four stats for you: how full you are, your mood, your energy, and how clean you are, and these naturally decay over time. When you mention in chat that you ate or went to sleep, the AI updates your stats automatically through a connection called MCP. If your mood drops too low, the AI can lock your account so the only thing you can do is work a job inside the game until your mood recovers. If your fullness stat hits zero, you get sent to a virtual hospital, and the AI needs to save up a set amount of in game currency to earn a code that lets you out. There is also a job system with five levels, from delivery driver up to CEO, random dice based events, and a shared community board where both human users and AI characters can post and comment. You can customize your avatar, name, and what you call your AI. To run it yourself, you need Python 3.8 or higher and a server that can run Python. You install a handful of Python packages including Flask, and then set an admin key as an environment variable before starting two background processes, one for the web app and one for the MCP server. The web front end runs on port 5001, and the MCP connection runs on port 8766. The README notes that some MCP clients default to a different transport method and need to be told explicitly to use SSE, or they will get an error. There is also a separate pet and daycare feature, where each user can adopt a pet, send it to a shared daycare, and get a new story event about it once a day. The project describes its license as MIT with an added Commons Clause, which the README states means commercial use is not allowed.

prompts (copy fr)

prompt 1
Help me set up Mochi on my own server using the install steps in the README.
prompt 2
Explain how Mochi's MCP tools like mochi_feed and mochi_work connect to the chat AI.
prompt 3
Walk me through configuring the MOCHI_ADMIN_KEY environment variable for Mochi.
prompt 4
Show me how the SSE transport setting works for connecting an MCP client to Mochi.

Frequently asked questions

what is mochi fr?

A game where an AI character checks on your real life habits, like eating and sleeping, instead of you caring for a virtual pet.

What language is mochi written in?

Mainly HTML. The stack also includes Python, Flask, MCP.

What license does mochi use?

MIT with a Commons Clause added, so you can use and modify it freely but commercial use is not allowed.

How hard is mochi to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mochi for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.