Skip to content

Add Engram-AI — experience-driven memory layer for AI agents#602

Closed
Okabe-Shota wants to merge 1 commit intoShubhamsaboo:mainfrom
Okabe-Shota:add-engram-ai
Closed

Add Engram-AI — experience-driven memory layer for AI agents#602
Okabe-Shota wants to merge 1 commit intoShubhamsaboo:mainfrom
Okabe-Shota:add-engram-ai

Conversation

@Okabe-Shota
Copy link
Copy Markdown

Add Engram-AI to LLM Apps with Memory Tutorials

What it does:

Engram-AI (engram-forge on PyPI) is an experience-driven memory layer for AI agents. Most memory systems store facts; Engram-AI stores causality — what the agent did, what happened, and whether it worked:

from engram_ai import Forge

forge = Forge()
forge.record(
    action="Used Optional[str] in API response model",
    context="REST endpoint design",
    outcome="User rejected — 'no null values please'",
    valence=-0.8,  # learning signal: -1.0 to +1.0
)

# Query past experiences, partitioned by outcome
result = forge.query("REST API design")
# result["best"] — what worked
# result["avoid"] — what to avoid

# Crystallize repeated patterns into reusable skills
skills = forge.crystallize(min_experiences=3)

# Write learned skills back to agent config
forge.evolve("./CLAUDE.md")

Why it's relevant to this list:

  • Directly addresses the problem of AI agents repeating the same mistakes across sessions
  • Works with Claude Code (automatic recording via hooks), plus standalone Python API
  • No API key required for core features

Links:

License: Apache 2.0 | Python 3.10+

Copilot AI review requested due to automatic review settings March 18, 2026 06:12
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Engram-AI (engram-forge) as an additional entry under the “LLM Apps with Memory Tutorials” section of the awesome list, introducing an experience-driven memory layer concept for AI agents.

Changes:

  • Add a new README list item linking to the Engram-AI GitHub repo.
  • Describe Engram-AI’s experience schema (action/context/outcome/valence) and related features in the list entry.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

* [📝 LLM App with Personalized Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/llm_app_personalized_memory/)
* [🗄️ Local ChatGPT Clone with Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/local_chatgpt_with_memory/)
* [🧠 Multi-LLM Application with Shared Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/multi_llm_memory/)
* [🧠 Engram-AI — Experience-driven memory for AI agents](https://github.com/kajaha06251020/Engram-AI) - Records actions, contexts, outcomes, and valence (−1.0 to +1.0). Experiences crystallize into skills, skills evolve into agent config (CLAUDE.md). Claude Code hooks + 10-tool MCP server. No API key required for core features. `pip install engram-forge`
* [📝 LLM App with Personalized Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/llm_app_personalized_memory/)
* [🗄️ Local ChatGPT Clone with Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/local_chatgpt_with_memory/)
* [🧠 Multi-LLM Application with Shared Memory](advanced_llm_apps/llm_apps_with_memory_tutorials/multi_llm_memory/)
* [🧠 Engram-AI — Experience-driven memory for AI agents](https://github.com/kajaha06251020/Engram-AI) - Records actions, contexts, outcomes, and valence (−1.0 to +1.0). Experiences crystallize into skills, skills evolve into agent config (CLAUDE.md). Claude Code hooks + 10-tool MCP server. No API key required for core features. `pip install engram-forge`
@awesomekoder
Copy link
Copy Markdown
Contributor

Thanks for the interest! This PR adds README links but doesn't include runnable code in its own folder. For this repo, we need self-contained tutorials with the actual implementation included.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants