OpenHuman Memory Tree Configuration Guide

Memory Tree is OpenHuman's most powerful feature — a persistent memory system that stores structured data about your conversations, files, emails, and code repositories. Unlike traditional chatbots that forget everything after each session, Memory Tree lets your AI agent remember you.

What is Memory Tree?

Memory Tree organizes information in a tree structure. Each node represents a piece of knowledge — a person you mentioned, a project you're working on, a preference you expressed. The tree grows naturally as you use OpenHuman.

Persistent storage — data survives app restarts and computer reboots
Automatic organization — related information is grouped together
Context-aware retrieval — the AI pulls relevant memories when needed

Enabling Memory Tree

Memory Tree is enabled by default in OpenHuman. You can verify and configure it in the settings panel or config.toml:

[memory_tree] enabled = true storage_path = "~/.openhuman/memory_tree" max_depth = 10 auto_prune = true

How Memory Tree Works

When you talk to OpenHuman, it automatically extracts key information and stores it:

Entities — people, companies, projects mentioned
Relationships — how entities connect to each other
Preferences — your likes, dislikes, and habits
Context — what you're working on and your goals

Configuration Options

Storage Location

By default, the memory tree is stored at ~/.openhuman/memory_tree. You can change this with the storage_path option.

Max Depth

Controls how deep the tree can grow. Default is 10 — suitable for most users. Increase it if you have complex projects with many nested topics.

Auto-prune

When enabled, OpenHuman automatically removes old or irrelevant nodes to keep the tree manageable.

Best Practices

Be specific — the more detailed your conversations, the richer the memory tree
Review periodically — check what OpenHuman remembers about you
Backup regularly — the memory tree directory is your most valuable data

Backup Your Memory Tree

Your memory tree contains valuable context. Back it up regularly:

cp -r ~/.openhuman/memory_tree ~/backups/memory_tree_$(date +%Y%m%d)

OpenHuman Memory Tree Configuration Guide — Persistent AI Memory System