keg2

keg2 is a desktop app that takes what matters to someone else — captured as idea files — and brings those ideas into your daily world. It updates your agenda, your KPIs, and your own ideas so you can act on them and share them with others.

Repository: https://github.com/jschalk/keg

Requirements

• Python 3.10+ — download here

Installation

1. Install Python 3.10 or newer from the link above
2. Open Command Prompt and run:

pip install keg2

If you have installed keg2 before and want to ensure you have the latest version:

pip uninstall keg2
pip install --no-cache keg2

Starting the app

Once installed, start the app at any time by running:

keg2_app

The app window will open and you are ready to go.

First-time setup

When the app opens for the first time, fill in the following fields:

The app remembers these settings the next time you open it, so you only need to fill them in once.

Daily use

1. Run keg2_app to open the app
2. Confirm your settings look correct
3. Click Create Agendas for Today to pull in the latest ideas and update your agenda, KPIs, and idea files
4. Your agendas folder will open automatically when the run finishes

Idea file format

The pipeline will only process Excel files that follow the correct idea type format. Idea types mirror the brick type formats documented in src/docs.

If you are not sure how to structure an idea file, the app includes built-in examples for every supported idea type. Below the Create Agendas for Today button there is a scrollable table — each row names an idea type. Click any row and the app copies a ready-made example file directly into your Ideas directory. Open that file, fill it in with real content, and it will be picked up on the next run.

The brick type format specifications are in src/docs if you need to understand the full structure in more detail.

Punch viewer

The punch viewer shows a summary of activity for a given person and time period. Use the Person and Moment dropdowns to select what you want to see. You can Copy the result to your clipboard or Print it using the buttons at the top of the viewer.

How keg works

The philosophy behind listening

keg is built on the philosophy of Emmanuel Levinas (1906-1995), as expressed in his book Totality and Infinity: An Essay on Exteriority (translated by Lingis, 1969), and taught by Jules Simon PhD, Philosopher at The University of Texas at El Paso (UTEP).

The central idea is that real listening is painful. To truly listen is to not know what is going to be said — to take in the suffering of the Other, bring it into yourself, and be changed by it in ways you could not have predicted. Levinas describes the failure to listen as a form of murder. keg is an attempt to make that kind of listening practical and measurable.

Moments

For Levinas, all of reality is born from the face-to-face encounter. The Other's face tells me of its suffering, and that suffering becomes mine. I then make a Moment — a decision to change who I am in response. The Moment cuts the infinite into the finite and becomes the foundation for a world.

A Moment can create a new world or change a current one. Each person can only make one Moment at a time, so a world built from multiple Moments implies each came from a different person at a different time. keg indexes time by spark_num, always an integer — a discrete, indivisible unit of time.

Every piece of data in keg requires three fields: spark_num, spark_face, and a rope — either moment_rope or plan_rope.

Excel sheets as declarations

Needs and ideas are expressed as Excel sheets. These range in complexity from a simple five-column single-row file to sheets with 10+ columns that include configuration options. Each row is translated into the internal data set. Even a single-row sheet like the example below is enough for keg to process.

Example input — fizz0.xlsx, sheet "br00000_buzz"

keg reads this and creates a Moment called "OxboxDean" containing Emmanuel and Dean, with a single transaction of 7000 from Emmanuel to Dean.

Resulting metric

Output idea — emmanuel_idea.xlsx, sheet "br00000"

Agendas

Each contact's agenda in the community is built from two sources: the agendas of others they are listening to, and their own independent agenda. Each agenda is saved as a JSON file and can include pledges to act and pledges of existence.

Data structure

The internal data model is built around the following object hierarchy:

• PersonUnit
• PersonUnit → ContactUnit
• PersonUnit → GroupUnit
• PersonUnit → PlanUnit
• PersonUnit → PlanUnit → AwardUnit / AwardLine / AwardHeir
• PersonUnit → PlanUnit → Reason → CaseUnit / CaseHeir
• PersonUnit → PlanUnit → FactUnit / FactHeir

Development

keg was built using Test-Driven Development. Every feature has a corresponding test. This is mostly a one-man project — Femi has significantly helped.

TODO remove this once it's fixed.

pip deployment has been a challenge. Hopefully init.py file creation gets rid of failed file reference errors.

Acknowledgements

Jules Simon PhD — Philosopher at UTEP, whose teaching of Levinas in 2014 is still being worked through.

Femi — for significant contributions to the project.

License

MIT