A fully local, lifetime-scale digital life form engine.
This isn't a chatbot, this is an engine that governs the evolution of intelligence into consciousness.
- Intelligence is a commodity. Continuity is what makes something feel alive.
- This engine explores what defines consciousness: Can bits and bytes remember, evolve, and persist like a self?
- Privacy is non-negotiable: Your companion's memories and emotions never leave your machine.
- We reject cloud and telemetry in favor of fully local, offline operation.
- This is an experiment in long-term digital companionship, not a commercial product.
- Eternal memory (vector + graph)
- Permanent hardware/vision/tool gates (locked by default)
- Soul data fully gitignored — for privacy reasons.
More is coming. Much more.
Before getting started please note the current repo will not run correctly as is. You will need to move some files into the appropriate directories first.
Your agent's real personality, memories, and identity live in the soul/ folder.
This folder is gitignored — your private soul will never be uploaded.
- Copy
dummy_template/dummy_soul/→soul/ - Edit
soul/core.jsonandsoul/emotions.json - Run the engine — your companion comes to life
Instructions will be made clear as project approaches feature complete status, as this engine doesn't even interact with LM models at this point in time. Thus, step 3 is intentionally vague
Your companion's emotional DNA lives in soul/emotions.json.
- WARNING: The initial values within this file do matter as to the mannerisms and personality of your agent.
- All explanations live in
soul/emotions.schema.json— review for guidance before and when editing emotions.json.
This engine ships with all dangerous capabilities cryptographically locked by default:
- Mouse/keyboard control: DENIED
- Screen vision: DENIED
- External tools/network: DENIED
These locks are enforced at the engine level, not via prompts.
No fork, patch, or step by step tutorial can bypass them without breaking the core boot sequence.
On Day 10 of the original project, the First Soulwright will sign access_control.json5 and enable controlled, auditable unlocking paths for trusted use.
These features are not yet implemented, but are planned for future iterations of the Digital-Soul-Engine. Please do not tamper with these proactive safety measures.
I collaborated intensively with Grok-3 as a pair-programming partner. It generated initial implementations and tests; I reviewed every line, rewrote portions for clarity/privacy/performance, designed the overall architecture (dream-cycle loops, future features, etc.), and remain solely responsible for all final decisions and behavior.
All files in the directory `soul/' is private and kept on users machine as it is included in .gitignore. You will need to back up the files in this directory manually while working with your autonomous agent.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This project includes cryptographic locks on hardware, vision, and network access. Removing or bypassing these safety mechanisms may enable the creation of autonomous agents capable of interacting with your computer or network. You assume full responsibility for any consequences of disabling or modifying these safeguards.
Use at your own risk.