LibreAI / AI Agents / Memary
// agents · kingjulio8238/Memary

Memary

The open-source memory layer for autonomous agents — knowledge-graph memory that emulates human memory

★ 2.7k stars⑂ 205 forksMITupdated 2024-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Memary is an open-source ai agents project by kingjulio8238 (kingjulio8238/Memary on GitHub). It has 2,655 GitHub stars and 205 forks, is released under the MIT license, and was last updated on GitHub on 22 October 2024.

GitHub stars
2,655
Forks
205
License
MIT
Last updated on GitHub
22 October 2024
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide whether you are adding memory to your own agent, or evaluating Memary through its bundled personal-agent demo.

  2. Get Memary

    pip install memary (Python <= 3.11.9), or clone the repo and install requirements for the full demo.

  3. Install and configure

    Create a .env with your graph database credentials (free FalkorDB or Neo4j instance) and any API keys, choose local Ollama models or OpenAI models, and edit the user/system persona files.

  4. Run your first session

    Launch the Streamlit app, chat with the agent, and watch its knowledge graph and memory modules update in the dashboard.

// features

Why people love it

Knowledge-graph memory

Facts are stored in a graph database (FalkorDB or Neo4j) via LlamaIndex, with recursive retrieval and multi-hop reasoning over entity subgraphs.

Auto-generated memory

After initialization, memory updates automatically as the agent interacts, and agent responses are written back into the graph.

Memory Stream

Captures every entity inserted into the graph with timestamps, enabling timeline and theme analysis of a user's interests.

Entity Knowledge Store

Tracks frequency and recency per entity to rank what the user knows deeply versus superficially.

Bundled ReAct agent and tools

A demo ChatAgent with default tools (search, vision via LLaVA, location via Google Maps, stocks), plus add_tool/remove_tool for custom tools.

Multi-graph support

With FalkorDB, multiple graphs keyed by user/agent ID let different agents keep separate memory contexts.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone Memary for the full demo; the library alone installs from PyPI in step 2.

    git clone https://github.com/kingjulio8238/Memary.git
    cd Memary
  2. Install the package

    Install Memary (Python <= 3.11.9 per the README) and, for a local checkout, its requirements.

    pip install memary
    # local checkout: pip install -r requirements.txt
  3. Run the demo app

    Configure .env and the persona files first, then start the Streamlit app.

    cd streamlit_app
    streamlit run app.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Memary?

kingjulio8238 created and maintains it; documentation is at kingjulio8238.github.io.

Is Memary free?

Yes, MIT-licensed. Its graph databases (FalkorDB/Neo4j) have free tiers, and models can run locally via Ollama.

Does it need a paid API key?

Not necessarily — it defaults to local Ollama models. Hosted options (OpenAI, Perplexity, Google Maps, Alpha Vantage) use your own keys if you enable those tools.

How does it compare to Memobase?

Memobase focuses on user profiles for chatbots as a service. Memary is a research-oriented memory layer centered on a knowledge graph plus memory-stream/entity-store modules you embed yourself.

How do I get started?

pip install memary, set up a free FalkorDB or Neo4j instance in .env, then run the Streamlit demo from the repo. Note the repo's last push was in October 2024.

// keep exploring

Similar tools

AI Agents

memvid

A serverless, single-file memory layer for AI agents - replace complex RAG pipelines

★ 16.6k starsApache-2.0
View guide →
AI Agents

zep

Examples and integrations for Zep — the memory layer for AI agents.

★ 5.0k starsApache-2.0
View guide →
AI Agents

iwe

A markdown knowledge graph with LSP for editors and MCP for agents.

★ 1.7k starsApache-2.0
View guide →
AI Agents

m_flow

M-flow is a bio-inspired cognitive memory engine for AI agents — a graph alternative to flat RAG

★ 4.5k starsApache-2.0
View guide →
AI Agents

graphiti

Real-time knowledge graphs that give agents a memory with structure.

★ 31.5k starsApache-2.0
View guide →
AI Agents

basic-memory

Basic Memory: local-first MCP memory so you and your AI tools build a shared knowledge graph in Markdown

★ 4.1k starsAGPL-3.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if Memary is not the right fit.

Get Memary

Free and open — grab the source, star the repo, and start creating.