project name
milo-dixon or first_body
or whatever_name_was_available
I have been called other things. My surname was assigned, and my given name was inherited. My middle name is shouted most often, but that has since been reclaimed. I chose a variation of my middle name later to identify, when I shook the hand of someone who didn’t know me at all.
Then I typed that name into a box on a form that was far too small to hold a life.
This repository contains the current version of a person still under active development.
It’s running but it’s not very stable.
description
This project attempts to maintain a viable human system under rapidly changing environmental conditions.
Primary functions include:
- Remembering and forgetting incorrectly
- Profusely apologizing
- Translating fear into productivity, and then translating productivity back into fear
- Expressing love
- Surviving
This project was originally built without a full requirements document.
Most early commits were made in a state of anxiety or panic.
Several critical dependencies were discovered only after failure.
installation
First, choose a body (any body will work), but keep an eye out for the ones with unsupported firmware, missing permissions, or family configurations that may affect long-term performance and self-worth.
Place the body in a house.
Add weather. Add language. Add a name. Add hunger. Add one person who means well Add at least one parent who is overbearing, and another parental figure who is preoccupied.
Wait.
The project will begin compiling.
Do not interrupt this process unless there is crying. There will be crying.
Interrupt anyway.
requirements
This project requires:
python >= 3.10
or any language that can name what happened but also will not become what happened.
memory
grief
time
touch
water
permission
a room with a door
someone who stays when they say they will go
someone who tells the truth gently
someone who tells the truth directly
Optional but recommended:
therapy
sunlight
stable_income
friends_who_notice
a city, urban, with a diverse population
a morning routine, not intended to be followed
a reason to keep the plant alive
dependencies
This project depends on several external packages:
mother
father
weather
school
money (unfortunately)
language
body
desire
memory
shame
internet
grief
Some dependencies are deprecated but will still load at startup. There is another set of dependencies that cannot be removed without breaking the build. There are dependencies that were never installed correctly but the system learned to route around them.
Some dependencies are people. Please handle those carefully. They are not libraries or utilities and are not always available when called.
quick start
To begin:
wake up
check if the body is still here
drink water
answer one message, answer honestly
dread ≠ prophecy
continue
If the program freezes, try the following:
sit down
name five objects in the room
unclench jaw
take medication if prescribed
open window
call someone
do not debug the entire life at once
If the program returns:
ERROR: no future found
do not trust this output.
This is a known issue in earlier versions.
configuration
Create a local file called:
.env
Add the following variables:
NAME=
EMERGENCY_CONTACT=
REASON_TO_CONTINUE=
REASON_TO_CONTINUE_BACKUP=
REASON_TO_CONTINUE_IF_FIRST_REASON_FAILS=
Do not commit this file publicly. It sounds like it’s supposed to be a secret but it’s not.
Some values may change over time. This is expected behavior.
usage
This project can be run in several modes.
default mode
while alive:
try:
be_a_person()
except Fear:
pretend_to_be_fine()
This mode is the original implementation but is not recommended for long-term use.
maintenance mode
while alive:
eat()
sleep()
ask_for_help()
tell_the_truth()
repair_self()
This mode is slower and produces fewer impressive commits. It has significantly improved uptime.
recovery mode
for wound in wounds:
if wound.is_ready():
clean(wound)
else:
remember_it()
Do not force any wounds open by accident or from overstimulation, as this assumes avoidance can replace healing. Avoid exposure, as this assumes bravery when it is punishment.
known issues
The following issues are currently unresolved:
ISSUE-001: believes love is earned
ISSUE-002: confuses usefulness and safety
ISSUE-003: stores criticism in long-term memory
ISSUE-004: automatically deletes compliments after reading
ISSUE-005: apologizes internally more than externally
ISSUE-006: assumes silence means danger
ISSUE-007: danger means fault
ISSUE-008: fault means exile
Permanent fixes are in progress, and workarounds exist. Some bugs were inherited from upstream maintainers. This does not remove responsibility for downstream impact.
unsupported environments
This project may not function correctly in environments where:
- vulnerability is treated as inefficiency
- questions are punished
- love is conditional on performance
- anger is the only available documentation
- no one says what they mean
- the body is present but the person is not
In these environments, the project may appear operational while silently logging damage.
Check the logs, locate the child.
troubleshooting
The system keeps returning to an old memory.
This is not always a bug as some memories are unresolved processes. There are other memories waiting for permissions. A handful are asking to be renamed, and the most important memories are not asking for anything except not to be left alone in the dark.
Try:
memory.open(read_only=True)
Do not overwrite immediately without first observing.
The system wants to go back.
The project may attempt to locate a previous timestamp where damage inflicted appears preventable.
Example:
TARGET_MOMENT = "before I said it"
TARGET_MOMENT = "one minute before I left"
TARGET_MOMENT = "one week before I knew"
TARGET_MOMENT = "before I chose this version"
Most timestamps will not resolve. The past is not a writable directory.
Try creating an “apology” instead.
The system says it is broken.
Check whether it means:
broken
or:
uninformed
misinformed
forsaken
exhausted
starved
unforgiven
afraid
These are different errors which require different responses.
testing
Run the following tests regularly:
def test_body_is_not_enemy():
assert body.has_carried_you_this_far
def test_feeling_is_not_obstruction():
assert fear.can_be_observed
def test_past_is_not_current_environment():
assert then != now
def test_help_is_allowed():
assert asking != failing
def test_love_is_unconditional():
assert structure is not None
The project can reveal where attention is needed. Treat all test failures as lanterns.
contributing
Contributions are welcome but must follow the community guidelines. Before contributing, please use the THINK filtering.
T – Is it true?
H – Is it helpful?
I – Is it inspiring?
N – Is it Necessary?
K – Is it kind?
Do not submit unsolicited patches. Do not open a ticket for behavior you do not understand.
changelog
v0.1.0
Initial release. Cry. Sleep. Reach upward. Cannot recognize absence as punishment.
v0.5.0
Communicate needs with language Discovered words can become ideas and action
v1.0.0
Public-facing self deployed. Independent enough for school. Placed in proximity to others, unsure if they are alone
v1.8.3
Installed humor as primary defense method. Performance improved, visibility decreased.
v2.2.0
Major loss event, grief introduced. Several internal systems rewritten without consent of body. Backward compatibility broken.
v2.7.1
Discovered desire, marked as security vulnerability. Hid logs out of shame.
v3.0.0
Left home (or tried to). Some processes continued running remotely.
v3.6.4
Began telling the truth in controlled environments.
v4.0.0
Current release. Known issues remain. Documentation improved. Guilt pending.
roadmap
Future releases may include:
- saying no with conviction
- accepting care
- 7-8 hours of sleep
- Increase in number of emergency contacts
- Found family
- Motivation-oriented productivity
Long-term goal:
live
license
This project is released under the terms of continued optimization. Small portions may be quoted with attribution.
You may not claim ownership of any conditions.
This documentation may not be used to diagnose the author without consent.
You may not confuse access with understanding.
final note
This README will remain incomplete.
The project is alive so the documentation will (always) lag behind the latest build.
For now:
git status
returns:
modified: body
modified: memory
modified: language
modified: grief
untracked: mercy
Please keep this file open