EverMemoryArchive

English | 中文

EverMemoryArchive represents Ema Fan Club's initiative to imbue agents with continuously evolving personalities via long-term memory mechanisms. Our goal is to build AI companions that truly understand you—functioning as versatile assistants for daily operations while serving as empathetic partners attuned to your emotional landscape.

Framework

Getting Started

pnpm install

Environment Variables

Copy the .env.example file to .env and fill in your API keys:

cp .env.example .env

The following variables are required for LLM functionality:

• GEMINI_API_KEY: Your Gemini or OpenAI-compatible API key.
• GEMINI_API_BASE: API base URL (defaults to Google Gemini API).
• GEMINI_MODEL: The model name to use (e.g., gemini-3-flash-preview).

Run or develop application:

pnpm build
pnpm start
# or
pnpm dev

CLI

You can run the ema agent via CLI. Run the CLI with the following command to get usages.

pnpm -s cli

Contributing

See CONTRIBUTING.md for details.