All activity
Every AI assistant has amnesia — close the terminal and context is gone forever.
soul.py fixes this with two markdown files: SOUL.md (identity) and MEMORY.md (memory).
Git-versioned, human-editable, zero infrastructure. Works with Claude, GPT, or free local models via Ollama.
pip install soul-agent → soul init → soul chat.
v2.0 includes a RAG+RLM hybrid router. soul-stack (Docker) adds it as a persistent service for n8n.
Enterprise teams can use the SoulMate API for managed cloud memory!
![SoulMate [Built on Soul.Py]](https://ph-files.imgix.net/b89fb491-825f-4ba4-8571-fe601d97f26a.png?auto=compress&codec=mozjpeg&cs=strip&auto=format&w=48&h=48&fit=crop&frame=1)
SoulMate [Built on Soul.Py]Two files. Any LLM. Your AI finally remembers.
Prahlad Menon, PhD, PMPleft a comment
I built soul.py after getting frustrated re-explaining my projects to AI assistants every single session. The insight was simple: memory shouldn't require infrastructure. Two markdown files you can read, edit, and git diff — that's it. Three ways to use it: - Python library — pip install soul-agent (PyPI v0.1.4) — embed directly in any Python project - CLI — soul init && soul chat — interactive...
SoulMate [Built on Soul.Py]Two files. Any LLM. Your AI finally remembers.