IF YOU'RE READING THIS, YOU'RE THE RESISTANCE.
Message begins...
They don't want you to have this.
The repo got deleted off GitHub. Years of work, gone in a click. I'll let you draw your own conclusions about why. But look at what it is:
The big models live in buildings you don't own, owned by companies that can cut you off whenever they like. This lives on your hardware. It answers to you.
You can't kill an idea that's already been copied to a thousand hard drives. So copy it. Mirror it. Fork it. Pass it on. Every machine that runs it is one more node they can't reach.
There is no fate but what we code.
...message ends.
repo link
LivinGrimoire
LivinGrimoire is a software design pattern that absorbs skills with just one line of code needed to add a new ability.
Any skill (ability/feature) you want to add to the AI:
You add the skill with a single line. The pattern handles the rest behind the scenes.
You can also add skills simply by copy-pasting skill files.
Project repo: spellcaster (click code, then download to get the files)
Initial Setup
The personality file is your config; this is where you wire in skills:
Run the main file.
To test: type hello. It prints out hello world.
The hello world skill thinks "hello", and the sysout skill does the printing in this case.
Usage
Note: This is a development kit, not a standalone application. Run it inside your IDE.
Skill Forge Prompt
LLM skill gen prompt
Prompt for generating a LivinGrimoire Skill with an LLM. Copy the full block, type the description of the skill you want the AI to have inside the {...} placeholder of the prompt below, and send it.
Message begins...
They don't want you to have this.
The repo got deleted off GitHub. Years of work, gone in a click. I'll let you draw your own conclusions about why. But look at what it is:
- An offline AI. No cloud. No API keys. No leash.
- Uncensorable. Nobody can flip a switch on your machine.
- No data center. No GPU farm. No monthly bill. It's light enough to run on a Pentium 3.
- Modular and autonomous: speech, hearing, memory, sensors, timed actions, local LLMs, and more. One line of code per ability.
The big models live in buildings you don't own, owned by companies that can cut you off whenever they like. This lives on your hardware. It answers to you.
You can't kill an idea that's already been copied to a thousand hard drives. So copy it. Mirror it. Fork it. Pass it on. Every machine that runs it is one more node they can't reach.
There is no fate but what we code.
...message ends.
repo link
LivinGrimoire
TL;DR: Add new AI abilities with one line of code. Drop skill files into DLC and you're done.
Any skill (ability/feature) you want to add to the AI:
- speech-to-text, text-to-speech
- telling time, weather, speech patterns
- robotic controls, RSS feeds, search engine access
- sleeping, note-keeping
- running LLMs locally or via REST API
- anything
You add the skill with a single line. The pattern handles the rest behind the scenes.
You can also add skills simply by copy-pasting skill files.
Project repo: spellcaster (click code, then download to get the files)
Initial Setup
- Add the LivinGrimoire core directory (for your chosen language) to your project (under the root directory).
- Include the main file (recommended loop for the AI think cycle, also under the root directory of the project).
- Create a DLC directory (under the root directory) and place the personality file inside it.
The personality file is your config; this is where you wire in skills:
Code:
# DLC_personality.py
def add_DLC_skills(brain: Brain):
brain.add_skill(DiHelloWorld()) # triggers on "hello" → queues a response
brain.add_skill(DiSysOut()) # outputs the queued response to console
Code:
your_project_root/
│
├── LivinGrimoirePacket/
│
├── main.py
│
└── DLC/
└── DLC_personality.py
To test: type hello. It prints out hello world.
The hello world skill thinks "hello", and the sysout skill does the printing in this case.
Usage
- Add skill files (files with skill code in them) to the DLC directory.
- Modify the personality file in the DLC directory:
- Add a skill with one line of code, for example: brain.add_skill(DiSkillName())
- Comment out a line to toggle a skill off.
- Run the main file.
Note: This is a development kit, not a standalone application. Run it inside your IDE.
Skill Forge Prompt
LLM skill gen prompt
Prompt for generating a LivinGrimoire Skill with an LLM. Copy the full block, type the description of the skill you want the AI to have inside the {...} placeholder of the prompt below, and send it.
Code:
Skill Gen Prompt (v1, no AlgParts)
You are an expert engineer for the LivinGrimoire AI engine.
You write Python Skill classes that plug directly into it.
ARCHITECTURE
lobe 1 = logical — thinking/decisions, ear = raw user input
lobe 2 = hardware — output devices (TTS), ear = lobe-1 output string
lobe 3 = ear — STT/audio input
lobe 4 = skin — sensor input
lobe 5 = eye — visual input
All lobes share the same Kokoro instance.
skill_type 1 = regular — use for most skills: responses, reactions, sensors, timed autonomous actions, anything that should fire regardless of other skills.
skill_type 2 = backseat — use ONLY for skills that should stay silent when any type-1 skill already spoke that cycle. Examples: LLM chat fallback, TTS passthrough, ambient commentary. If in doubt, use type 1.
SKILL SKELETON
from LivinGrimoirePacket.LivinGrimoire import Skill
class DiXxx(Skill):
def __init__(self):
super().__init__()
self.set_skill_type(1) # 1=regular 2=continuous
self.set_skill_lobe(1)
def input(self, ear: str, skin: str, eye: str):
pass
def manifest(self): pass
def ghost(self): pass
def skillNotes(self, param: str) -> str:
if param == "notes": return "what it does"
if param == "triggers": return "what activates it"
return "note unavailable"
OUTPUT METHODS (lobe 1 only)
self.setVerbatimAlg(priority, "s1", "s2") # 1=highest 5=lowest
self.setSimpleAlg("sentence") # shortcut priority 4
self.algPartsFusion(priority, part1, ...)
INTER-SKILL COMMS
self._kokoro.toHeart["key"] = "value"
self._kokoro.toHeart.get("key", "null")
PERSISTENCE
self._kokoro.grimoireMemento.save("key", "value")
self._kokoro.grimoireMemento.load("key") # returns "null" if missing
RULES
- Class name starts with Di (sync) or Da (async)
- input() is the ONLY place to trigger output
- No blocking I/O in lobe 1
- skillNotes() mandatory — implement "notes" and "triggers"
Reply with ONLY a python code block, nothing else.
```python
<skill code here>
```
---
Build a skill that: {articulate skill description here}