git404hub

what is kindalive fr?

smithandrewjohn/kindalive — explained in plain English

Analysis updated 2026-05-18

156PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

Gives a robot emotions by simulating body chemistry, then shows the result as changing expressions on an LED or physical robot face.

vibe map

mindmap
  root((Kindalive))
    What it does
      Simulated body chemistry
      LLM turns text into chemicals
      LED face expressions
      Real time decay
    Tech stack
      Python core
      Claude or Ollama
      NiceGUI dashboard
      Raspberry Pi hardware
    Use cases
      Web dashboard demo
      Embed in own robot
      Physical LED face
      Servo animatronic face
    Audience
      Robotics hobbyists
      Python developers
      Maker community

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

Type a sentence and watch a simulated robot face react with a matching emotional expression.

VIBE 2

Embed the pure Python emotion engine into your own robot or hardware project.

VIBE 3

Drive a physical LED dot matrix or servo controlled face from a Raspberry Pi.

VIBE 4

Give different robots distinct personalities by changing their starting chemical baseline.

what's the stack?

PythonClaude APIOllamaNiceGUIRaspberry Pi

how it stacks up fr

smithandrewjohn/kindalivehelpmeeadice/bandori-pet-revhkust-c4g/domainshuttle
Stars156156156
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedevelopergeneralresearcher

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

how do i run it?

Difficulty · moderate time til it works · 30min

Core library has zero dependencies and runs offline, but the LLM interpreter needs either a Claude API key or a local model server.

in plain english

Kindalive is a Python project that gives a robot emotions by simulating body chemistry instead of using a simple label like happy or sad. Inside the system, a robot keeps track of the levels of eight simulated chemicals such as dopamine, cortisol, and oxytocin, and its emotional state is worked out from those levels rather than being set directly. You type in a sentence, such as you won the lottery or the cat is missing and a storm is coming, and a language model, either Claude in the cloud or a local model through something like Ollama, turns that sentence into chemical impulses. Those impulses feed into a neurochemical engine that tracks how the chemicals rise, decay, and interact with each other over time. The result is shown on a retro looking LED dot matrix robot face that changes expression to match the mix of chemicals, with the chemical levels displayed next to it. Each of the eight chemicals has its own speed of change: adrenaline fades within minutes for a quick burst of excitement, while serotonin shifts over hours to create a longer lasting mood. From these chemical levels the system also computes eight named emotions, such as happiness, anger, and anxiety, and twelve facial muscle movements based on a facial expression naming system, which directly drive the LED face. Each robot can be given a different starting chemistry, so a cheerful robot might start with higher serotonin and dopamine, while a calmer one starts with higher GABA. The core library is written in pure Python with no dependencies and can be embedded into your own robot project, while optional extras add a web dashboard, the Claude backend, or support for other OpenAI compatible models. There is also a command line tool for one off tests, and example code for driving real hardware like an eight by eight LED matrix or a servo controlled animatronic face, both of which can run on a Raspberry Pi.

prompts (copy fr)

prompt 1
Help me install Kindalive and run the web dashboard with a local Ollama model instead of Claude.
prompt 2
Explain how the eight simulated chemicals in Kindalive turn into the eight named emotions.
prompt 3
Show me how to wire a MAX7219 LED matrix to a Raspberry Pi to display the Kindalive robot face.
prompt 4
Walk me through embedding the Kindalive Robot class into my own Python project without the web UI.

Frequently asked questions

what is kindalive fr?

Gives a robot emotions by simulating body chemistry, then shows the result as changing expressions on an LED or physical robot face.

What language is kindalive written in?

Mainly Python. The stack also includes Python, Claude API, Ollama.

How hard is kindalive to set up?

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

Who is kindalive for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.